ansible一键安装GreatSQL并构建MGR集群

青旅半醒 2022-08-31 13:26 181阅读 0赞

本文首发于 GreatSQL社区 微信公众号。

原创内容未经授权不得随意使用，转载请联系小编并注明来源。

## 内容提纲 ##

*  1. 安装ansbile
 *  2. 配置ansible
 *  3. 建立ssh信任
 *  4. 测试ansible
 *  5. 使用ansible自动安装GreatSQL
 *   *  5.1 修改 /etc/hosts 设置正确的主机名
     *  5.2 下载GreatSQL-ansible安装包并解压缩
     *  5.3 利用ansible安装GreatSQL
     *  5.4 检查运行过程输出
     *  5.5 检查安装结果

> 利用ansible一键安装GreatSQL并完成MGR部署。

本次介绍如何利用ansible一键安装GreatSQL并完成MGR部署。

本文介绍的运行环境是CentOS 7.9：

[root@greatsql ~]# cat /etc/redhat-release
    CentOS Linux release 7.9.2009 (Core)
    
    [root@greatsql ~]# uname -a
    Linux greatsql 3.10.0-1160.11.1.el7.x86_64 #1 SMP Fri Dec 18 16:34:56 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux

## 1. 安装ansbile ##

直接用yum安装ansible即可：

[root@greatsql ~]# yum install -y ansible

查看版本号，确认安装成功：

[root@greatsql ~]# ansible --version
    ansible 2.9.21
      config file = /etc/ansible/ansible.cfg
      configured module search path = [u'/root/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
      ansible python module location = /usr/lib/python2.7/site-packages/ansible
      executable location = /usr/bin/ansible
      python version = 2.7.5 (default, Apr  2 2020, 13:16:51) [GCC 4.8.5 20150623 (Red Hat 4.8.5-39)]

这就OK了。

## 2. 配置ansible ##

修改 `/etc/ansible/hosts` 文件，把要安装GreatSQL的服务器IP加进去，例如：

[greatsql_dbs:children]
    greatsql_mgr_primary
    greatsql_mgr_secondary
    
    [greatsql_mgr_primary]
    172.16.16.10
    [greatsql_mgr_secondary]
    172.16.16.11
    172.16.16.12

如果是在本机安装，直接填写本机的内网IP地址或回环地址（127.0.0.1）均可。

上面这个主机列表，分为两个组，一个是选择作为MGR PRIMARY节点的组 **greatsql\_mgr\_primary**，只有一个主机。

另一组选择作为SECONDARY节点 **greatsql\_mgr\_secondary**，有两个主机。

两个组也可以合并一起，成为一个新的组 **greatsql\_dbs**。

## 3. 建立ssh信任 ##

为了简单起见，直接建立ssh信任，方便ansible一键安装。

首先生成ssh key：

[root@greatsql ~]# ssh-keygen

使用缺省值，提示输入passphrase时，敲回车使用空的passphrase。

将ssh key复制到目标服务器上：

[root@greatsql ~]# ssh-copy-id root@172.16.16.10

按提示输入口令，完成后测试使用ssh登录不再提示输入口令。如果是在本机安装，那么ssh-copy-id也要对本机执行一遍。

或者手动将ssh key复制到远程主机上，写到 ~/.ssh/authorized\_keys 文件中（注意不要折行、断行）。

## 4. 测试ansible ##

随意执行一个指令，测试ansibile可连接远程主机：

[root@greatsql ~]# ansible greatsql_dbs -a "uptime"
    172.16.16.10 | CHANGED | rc=0 >>
     15:29:46 up 250 days, 19:40,  2 users,  load average: 0.04, 0.08, 0.07
    172.16.16.11 | CHANGED | rc=0 >>
     15:29:46 up 303 days, 17:57,  3 users,  load average: 0.10, 0.13, 0.13
    172.16.16.12 | CHANGED | rc=0 >>
     15:29:47 up 194 days, 18:08,  2 users,  load average: 0.07, 0.13, 0.10

这就表示可以正常运行了。

## 5. 使用ansible自动安装GreatSQL ##

### 5.1 修改 /etc/hosts 设置正确的主机名 ###

修改几个服务器上的 /etc/hosts 文件，加入正确的主机名配置：

[root@greatsql ~]# cat /etc/hosts
    
    172.16.16.10 mgr1
    172.16.16.11 mgr2
    172.16.16.12 mgr3

### 5.2 下载GreatSQL-ansible安装包并解压缩 ###

打开GreatSQL-Ansible项目主页：*https://gitee.com/GreatSQL/GreatSQL-Ansible*

找到页面右侧“发行版”，进入，选择 " GreatSQL-8.0.23-14-Linux.x86\_64-ansible-v0.1-alpha.tar.xz" 这个二进制包下载到服务器上：

[root@greatsql ~]# cd /opt/greatsql/; wget -c "https://gitee.com/xxx/GreatSQL-8.0.23-14-Linux.x86_64-ansible-v0.1-alpha.tar.xz"
    
    [root@greatsql ~]# tar zxf GreatSQL-8.0.23-14-Linux.x86_64-ansible-v0.1-alpha.tar.xz

**特别提醒**：上述安装包是我的内部测试版本，不是正式发布的版本。

解压缩后，能看到除了 *GreatSQL-8.0.23-14-Linux.x86\_64.tar.xz* 安装包之外，还有GreatSQL-ansible一键安装相关文件：

[root@greatsql ~]# ls -la
    -rw-r--r-- 1 root root      327 Jul 13 11:26 check_mysql.yml
    -rw-r--r-- 1 root root 15431496 Jul 13 12:00 GreatSQL-8.0.23-14-Linux.x86_64-ansible-v0.1-alpha.tar.xz
    -rw-r--r-- 1 root root 15428212 Jul  7 12:43 GreatSQL-8.0.23-14-Linux.x86_64.tar.xz
    -rw-r--r-- 1 root root     4393 Jul  7 15:33 greatsql.yml
    -rw-r--r-- 1 root root      357 Jul  7 15:08 vars.yml

几个文件作用分别介绍下：

*  GreatSQL-8.0.23-14-Linux.x86\_64.tar.xz，GreatSQL二进制安装包。
 *  greatsql.yml，ansible一键安装脚本。
 *  check\_mysql.yml，MySQL进程、端口预检查脚本。
 *  vars.yml，定义一些变量的脚本，里面的变量名有些需要修改以适应各自不同的安装环境。

### 5.3 利用ansible安装GreatSQL ###

开始执行前，需要确认 *vars.yml* 文件中下面这些相关参数是否要调整：

work_dir: /opt/greatsql
    extract_dir: /usr/local
    data_dir: /data/GreatSQL
    file_name: GreatSQL-8.0.23-14-Linux.x86_64.tar.xz
    base_dir: /usr/local/GreatSQL-8.0.23-14-Linux.x86_64
    my_cnf: /etc/my.cnf
    mysql_user: mysql
    mysql_port: 3306
    mgr_user: repl
    mgr_user_pwd: repl4MGR
    mgr_seeds: '172.16.16.7:33061,172.16.16.10:33061,172.16.16.16:33061'
    wait_for_start: 60

下面是关于这些参数的解释：

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>默认值</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>work_dir</td> 
   <td>/opt/greatsql</td> 
   <td>工作目录，将下载的安装包放在本目录，可根据需要自行调整</td> 
  </tr> 
  <tr> 
   <td>extract_dir</td> 
   <td>/usr/local</td> 
   <td>GreatSQL二进制包解压缩后放在 /usr/local下，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>data_dir</td> 
   <td>/data/GreatSQL</td> 
   <td>GreatSQL运行时的datadir，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>file_name</td> 
   <td>GreatSQL-8.0.23-14-Linux.x86_64.tar.xz</td> 
   <td>GreatSQL二进制包文件名，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>base_dir</td> 
   <td>/usr/local/GreatSQL-8.0.23-14-Linux.x86_64</td> 
   <td>GreatSQL的basedir，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>my_cnf</td> 
   <td>/etc/my.cnf</td> 
   <td>my.cnf配置文件路径，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>mysql_user</td> 
   <td>mysql</td> 
   <td>运行GreatSQL对应的user、group，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>mysql_port</td> 
   <td>3306</td> 
   <td>GreatSQL运行时的监听端口，【不建议调整】</td> 
  </tr> 
  <tr> 
   <td>mgr_user</td> 
   <td>repl</td> 
   <td>MGR账户</td> 
  </tr> 
  <tr> 
   <td>mgr_user_pwd</td> 
   <td>repl4MGR</td> 
   <td>MGR账户密码</td> 
  </tr> 
  <tr> 
   <td>mgr_seeds</td> 
   <td>172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061</td> 
   <td>定义MGR运行时各节点的IP+端口列表，【需要自行调整】</td> 
  </tr> 
  <tr> 
   <td>wait_for_start</td> 
   <td>60</td> 
   <td>初次启动时，要先进行一系列数据文件初始化等工作，后面的MGR初始化工作要等待前面的先完成，如果第一安装失败，可以将这个时间加长</td> 
  </tr> 
 </tbody> 
</table>

执行下面的命令一键完成GreatSQL的安装、初始化，加入systemd服务、以及MGR初始化等所有工作：

[root@greatsql ~]# ansible-playbook ./greatsql.yml

### 5.4 检查运行过程输出 ###

安装时会先行检查是否已有mysqld进程在运行，或者3306端口上是否已有其他服务。

如果是的话，则输出内容可能会是这样的：

PLAY [install GreatSQL] *****************************************************************************************************************************
    
    TASK [Gathering Facts] ******************************************************************************************************************************
    ok: [172.16.16.10]
    ok: [172.16.16.11]
    ok: [172.16.16.12]
    
    TASK [check mysql port] *****************************************************************************************************************************
    changed: [172.16.16.10]
    changed: [172.16.16.11]
    changed: [172.16.16.12]
    
    TASK [check mysql processor] ************************************************************************************************************************
    changed: [172.16.16.10]
    changed: [172.16.16.11]
    changed: [172.16.16.12]
    
    TASK [modify selinux config file] *******************************************************************************************************************
    skipping: [172.16.16.10]
    skipping: [172.16.16.11]
    skipping: [172.16.16.12]

看到有 **skipping** 以及 **skipped=N** 字样。而如果是正常安装，则会输出类似下面的内容：

PLAY [install GreatSQL] *****************************************************************************************************************************
    
    TASK [Gathering Facts] ******************************************************************************************************************************
    ok: [172.16.16.10]
    ok: [172.16.16.11]
    ok: [172.16.16.12]
    
    TASK [check mysql port] *****************************************************************************************************************************
    changed: [172.16.16.10]
    changed: [172.16.16.11]
    changed: [172.16.16.12]
    ...
    PLAY RECAP ******************************************************************************************************************************************
    172.16.16.10               : ok=26   changed=13   unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
    172.16.16.11               : ok=26   changed=13   unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
    172.16.16.12               : ok=26   changed=13   unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

### 5.5 检查安装结果 ###

有 **ok** 以及 **skipped=0** 字样，这就表示都被正常被执行了，此时应该已经安装成功了，检查一下：

[root@greatsql ~]# systemctl status greatsql
    ● greatsql.service - GreatSQL Server
       Loaded: loaded (/usr/lib/systemd/system/greatsql.service; disabled; vendor preset: disabled)
       Active: active (running) since Tue 2021-07-06 20:55:33 CST; 45s ago
         Docs: man:mysqld(8)
               http://dev.mysql.com/doc/refman/en/using-systemd.html
      Process: 31320 ExecStartPre=/usr/local/GreatSQL-8.0.23-14-Linux.x86_64/bin/mysqld_pre_systemd (code=exited, status=0/SUCCESS)
     Main PID: 31348 (mysqld)
       Status: "Server is operational"
       CGroup: /system.slice/greatsql.service
               └─31348 /usr/local/GreatSQL-8.0.23-14-Linux.x86_64/bin/mysqld
    
    Jul 06 20:55:31 greatsql systemd[1]: Starting GreatSQL Server...
    Jul 06 20:55:33 greatsql systemd[1]: Started GreatSQL Server.

检查MGR服务运行状态：

以上ansible脚本已上传到gitee仓库中，详见：*https://gitee.com/GreatSQL/GreatSQL-Ansible*。

相应的测试版二进制包也可以在这里下载：*https://gitee.com/GreatSQL/GreatSQL-Ansible/releases*。

搞定，收工。

水平有限，也请各位读者大人帮忙看看ansible安装脚本里有哪些可以优化的地方，感谢。

Enjoy GreatSQL & Ansible :)

--------------------

**文章推荐：**

*  [MGR最佳实践(MGR Best Practice)][MGR_MGR Best Practice]
 *  [万里数据库MGR Bug修复之路][MGR Bug]
 *  [在Docker中部署GreatSQL并构建MGR集群][Docker_GreatSQL_MGR]
 *  [将GreatSQL添加到系统systemd服务][GreatSQL_systemd]
 *  [金融应用场景下跨数据中心的MGR架构方案][MGR]  
    
 *  [InnoDB Cluster+GreatSQL快速部署MGR集群，并实现读写分离和故障自动转移][InnoDB Cluster_GreatSQL_MGR]
 *  [利用GreatSQL部署MGR集群，并完成添加新节点 、滚动升级、切主][GreatSQL_MGR_]
 *  [《叶问》33期，MGR最佳配置参考，PFS里的监测指标要全开吗，mysqld进程占用内存过高怎么排查][33_MGR_PFS_mysqld]

--------------------

扫码加入GreatSQL/MGR交流**QQ群**

![a978a1e812154cbb9b76e4968e0f1d8f.png][]

点击文末“**阅读原文**”直达老叶专栏

[MGR_MGR Best Practice]: http://mp.weixin.qq.com/s?__biz=MzkzMTIzMDgwMg%3D%3D&chksm=c26f6633f518ef25f19309e4b01ce5d4527d945a2a030b66a9d9bbaa598cb668eca30cb91a0f&idx=1&mid=2247484174&scene=21&sn=4f795e889e3778876b09143c4ffdc770#wechat_redirect
[MGR Bug]: http://mp.weixin.qq.com/s?__biz=MzkzMTIzMDgwMg%3D%3D&chksm=c26f64abf518edbdb278f1c21e98e39dc73b78397d01c2d583450a1da6d72a4ff32a0ec6db9c&idx=1&mid=2247483798&scene=21&sn=21fc1b1797074e002e1c684263b731e8#wechat_redirect
[Docker_GreatSQL_MGR]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b40488a4cc95e2f4a7750a3cad05fd70d3b9b5f366ded103e66e16f2cdda6f67fa231803c&idx=1&mid=2653936162&scene=21&sn=fa76aa58c0262d6a4e43c675f305db6d#wechat_redirect
[GreatSQL_systemd]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b43ea8a4ccafc0edffe28125815e5a490370463d7f7c00436f5d58b47df58affd0afe263d&idx=1&mid=2653936000&scene=21&sn=d21f6f3a89e03c08663df5b34f6b09f8#wechat_redirect
[MGR]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b43108a4cca06841d2adf3a63dfe6af99df09b09164e8676d99cb08fc5e569bfc543a0ccf&idx=1&mid=2653935994&scene=21&sn=91c596c81944aabd396d33f4924aac26#wechat_redirect
[InnoDB Cluster_GreatSQL_MGR]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b43308a4cca26c2db9912a9ce5e2d73df1a10e7415f83538742b92e5475a0b11b88e39f4c&idx=1&mid=2653935962&scene=21&sn=38f2acfb147f16ae8daaa6a48a3102ae#wechat_redirect
[GreatSQL_MGR_]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b43258a4cca336b0260c6b9cfc363f10596c775bdd0408d89dca855f3c7949911aa50ec8f&idx=1&mid=2653935951&scene=21&sn=ec8794371cd6f7677a5355b7e7ac39ea#wechat_redirect
[33_MGR_PFS_mysqld]: http://mp.weixin.qq.com/s?__biz=MjM5NzAzMTY4NQ%3D%3D&chksm=bd3b436b8a4cca7ddf138db1d2342aa19f0452bff97beb2f5015cf0eb377a7d2a6899d1c3c05&idx=1&mid=2653935873&scene=21&sn=7511853d63145b7d72ae533586b6ad81#wechat_redirect
[a978a1e812154cbb9b76e4968e0f1d8f.png]: /images/20220829/bb54b9fd62f94dba8edc40aa65a2cfe1.png