基于inception的自动化SQL操作平台
python：3.4
django：1.8.17
mysql : 5.6及以上
linux : 64位linux操作系统均可
- 自动审核：
发起SQL上线，工单提交，由inception自动审核，审核通过后需要由审核人进行人工审核 - 人工审核：
工单DBA人工审核、审核通过自动执行SQL.
为什么要有人工审核？
这是遵循运维领域线上操作的流程意识，一个工程师要进行线上数据库SQL更新，最好由另外一个工程师来把关.
很多时候DBA并不知道SQL的业务含义，所以人工审核最好由其他研发工程师或研发经理来审核. 这是archer的设计理念. - 回滚数据展示
- 主库集群配置
- 用户权限配置
工程师角色（engineer）与审核角色（review_man）:工程师可以发起SQL上线，在通过了inception自动审核之后，需要由人工审核点击确认才能执行SQL.
还有一个特殊的超级管理员即可以上线、审核，又可以登录admin界面进行管理. - 历史工单管理，查看、修改、删除
- 可通过django admin进行匹配SQL关键字的工单搜索
- 发起SQL上线，可配置的邮件提醒审核人进行审核
- 在发起SQL上线前，自助SQL审核，给出建议
- 审核通过正在执行中的工单，如果是由pt-OSC执行的SQL会显示执行进度，并且可以点击中止pt-OSC进程
- 合理的数据库设计和规范很有必要，尤其是MySQL数据库，内核没有oracle、db2、SQL Server等数据库这么强大，需要合理设计，扬长避短。互联网业界有成熟的MySQL设计规范，特此撰写如下。请读者在公司上线使用archer系统之前由专业DBA给所有后端开发人员培训一下此规范，做到知其然且知其所以然。
下载链接： https://github.com/jly8866/archer/raw/master/docs/mysql_db_design_guide.docx
- archer/archer/settings.py
- 环境准备：
(1)克隆代码到本地: git clone https://github.com/jly8866/archer.git 或 下载zip包
(2)安装mysql 5.6实例，请注意保证mysql数据库默认字符集为utf8或utf8mb4
(3)安装inception - 安装python3：(强烈建议使用virtualenv或venv等单独隔离环境！)
tar -xzvf Python-3.4.1.tar.gz
cd Python-3.4.1
./configure --prefix=/path/to/python3 && make && make install 或者rpm、yum、binary等其他安装方式 - 安装所需相关模块：
(1)django：
tar -xzvf Django-1.8.17 && cd Django-1.8.17 && python3 setup.py install
或者pip3 install Django==1.8.17
(2)Crypto:
pip3 install Crypto
pip3 install pycrypto - 给python3安装MySQLdb模块:
pip3 install pymysql
记得确保settings.py里有如下两行：
import pymysql
pymysql.install_as_MySQLdb()
由于python3使用的pymysql模块里并未兼容inception返回的server信息，因此需要编辑/path/to/python3/lib/python3.4/site-packages/pymysql/connections.py：
在if int(self.server_version.split('.', 1)[0]) >= 5: 这一行之前加上以下这一句并保存，记得别用tab键用4个空格缩进：
self.server_version = '5.6.24-72.2-log'
最后看起来像这样：
- 创建archer本身的数据库表：
(1)修改archer/archer/settings.py所有的地址信息,包括DATABASES和INCEPTION_XXX部分
(2)通过model创建archer本身的数据库表, 记得先去archer数据库里CREATE DATABASE
python3 manage.py makemigrations或python3 manage.py makemigrations sql
python3 manage.py migrate
执行完记得去archer数据库里看表是否被创建了出来 - mysql授权:
记得登录到archer/archer/settings.py里配置的各个mysql里给用户授权
(1)archer数据库授权
(2)远程备份库授权 - 创建admin系统root用户（该用户可以登录django admin来管理model）：
cd archer && python3 manage.py createsuperuser - 启动，有两种方式：
(1)用django内置runserver启动服务,需要修改debug.sh里的ip和port
cd archer && bash debug.sh
(2)用gunicorn启动服务，可以使用pip3 install gunicorn安装并用startup.sh启动，但需要配合nginx处理静态资源. (nginx安装这里不做示范)
- gunicorn的安装配置示例:
- pip3 install gunicorn
- cat startup.sh
- nginx配置示例：
- cat nginx.conf
- cat nginx.conf
- gunicorn的安装配置示例:
- 创建archer系统登录用户：
使用浏览器（推荐chrome或火狐）访问debug.sh里的地址：http://X.X.X.X:port/admin/sql/users/ ，如果未登录需要用到步骤7创建的admin系统用户来登录。
点击右侧Add users，用户名密码自定义，至少创建一个工程师和一个审核人（步骤7创建的用户也可以登录）后续新的工程师和审核人用户请用LDAP导入sql_users表或django admin增加 - 配置主库地址：
使用浏览器访问http://X.X.X.X:port/admin/sql/master_config/ ，点击右侧Add master_config
这一步是为了告诉archer你要用inception去哪些mysql主库里执行SQL，所用到的用户名密码、端口等。 - 正式访问：
以上步骤完毕，就可以使用步骤9创建的用户登录archer系统啦, 首页地址 http://X.X.X.X:port/
如果觉得以上安装步骤还是看不懂，可以看这一篇安装步骤，感谢网友@一条大河 的贡献：https://riverdba.github.io/2017/04/15/archer-install/
- settings中ENABLE_LDAP改为True,可以启用ldap账号登陆
- 如果使用了ldaps，并且是自签名证书，需要打开settings中AUTH_LDAP_GLOBAL_OPTIONS的注释
- centos需要执行yum install openldap-devel
- settings中以AUTH_LDAP开头的配置，需要根据自己的ldap对应修改
- 如果不想自己安装上述，可以直接使用做好的docker镜像，安装步骤：
- docker run -p 80:80 -d docker.gaoxiaobang.com/prod/archer (需要确保docker宿主机80端口能够使用)
- 浏览器直接访问http://宿主机ip:80/ 即可, 初始用户名密码为root/root
- docker镜像制作感谢@浩气冲天 协助
- 工单展示页：
- 自助审核SQL：
- 提交SQL工单：
- SQL自动审核、人工审核、执行结果详情页：
- 用户登录页：
- 用户、集群、工单管理：
- 工单统计图表：
8.pt-osc进度条，以及中止pt-osc进程按钮：
QQ群：524233225
- 报错：
原因：python3的pymysql模块会向inception发送SHOW WARNINGS语句，导致inception返回一个"Must start as begin statement"错误被archer捕捉到报在日志里.
解决：如果实在忍受不了，请修改/path/to/python3/lib/python3.4/site-packages/pymysql/cursors.py:338行，将self._show_warnings()这一句注释掉，换成pass，如下：
但是此方法有副作用，会导致所有调用该pymysql模块的程序不能show warnings，因此强烈推荐使用virtualenv或venv环境！