Ansible安装

本次介绍如何利用ansible快速安装GreatSQL并构建包含仲裁节点的MGR集群。

1. 安装准备

1.1 安装ansible

首先利用dnf/yum安装ansible：

  1. $ yum install -y ansible

1.2 配置ansible

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

  1. [greatsql_dbs:children]
  2. greatsql_mgr_primary
  3. greatsql_mgr_secondary
  4. greatsql_mgr_arbitrator
  6. [greatsql_mgr_primary]
  7. 172.16.16.10
  8. [greatsql_mgr_secondary]
  9. 172.16.16.11
  10. [greatsql_mgr_arbitrator]
  11. 172.16.16.12

上面这个主机列表，分为两个组，一个是选择作为MGR PRIMARY节点（或在多主模式中第一个需要初始化引导的节点）的组 greatsql_mgr_primary，只有一个主机。另一组选择作为SECONDARY节点 greatsql_mgr_secondary，有两个主机。两个组也可以合并一起，成为一个新的组 greatsql_dbs。

提醒

  1. 请填内网IP地址，因为MGR初始化时，默认使用用内网IP地址。
  2. 如果同时还要安装到本机，也请填写内网IP地址。
  3. 如果是要采用多主模式，在上面的配置中，把第一个需要初始化引导的节点放在 greatsql_mgr_primary 组里，其他节点照常放在 greatsql_mgr_secondary 组里。

1.3 建立ssh信任

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

首先生成ssh key

  1. $ ssh-keygen

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

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

  1. $ ssh-copy-id root@172.16.16.10

按提示输入口令，完成后测试使用ssh登录不再提示输入口令。如果是在本机安装，那么ssh-copy-id也要对本机执行一遍。或者手动将ssh key复制到远程主机上，写到 ~/.ssh/authorized_keys 文件中（注意不要折行、断行）。

1.4 测试ansible

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

  1. $ ansible greatsql_dbs -a "uptime"
  2. 172.16.16.10 | CHANGED | rc=0 >>
  3.  15:29:46 up 250 days, 19:40,  2 users,  load average: 0.04, 0.08, 0.07
  4. 172.16.16.11 | CHANGED | rc=0 >>
  5.  15:29:46 up 303 days, 17:57,  3 users,  load average: 0.10, 0.13, 0.13
  6. 172.16.16.12 | CHANGED | rc=0 >>
  7.  15:29:47 up 194 days, 18:08,  2 users,  load average: 0.07, 0.13, 0.10

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

1.5 下载GreatSQL-Ansible安装包

打开GreatSQL-Ansible项目主页：https://gitee.com/GreatSQL/GreatSQL-AnsibleAnsible安装 - 图1 (opens new window)

找到页面右侧“发行版”，进入，选择 “ GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz “ 这个二进制包下载到服务器上：

  1. $ cd /opt/greatsql/; wget -c "https://gitee.com/xxx/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz"
  3. $ tar -Jxvf GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz

解压缩后，能看到除了 GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xz 安装包之外，还有GreatSQL-ansible一键安装相关文件：

  1. $ cd /opt/greatsql/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible
  2. $ ls -la
  3. -rw-r--r-- 1 root root      333 Aug  8 11:04 check_mysql.yml
  4. -rw-r--r-- 1 root root 46324036 Aug  8 11:09 GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xz
  5. -rw-r--r-- 1 root root     8920 Aug  8 12:41 greatsql.yml
  6. drwxr-xr-x 3 root root      103 Aug  8 11:07 mysql-support-files
  7. -rw-r--r-- 1 root root      869 Aug  8 11:04 README.en.md
  8. -rw-r--r-- 1 root root      795 Aug  8 11:04 README.md
  9. -rw-r--r-- 1 root root      413 Aug  8 14:03 vars.yml

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

  • GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xz，GreatSQL二进制minimal安装包。
  • greatsql.yml，ansible一键安装脚本。
  • check_mysql.yml，MySQL进程、端口预检查脚本。
  • vars.yml，定义一些变量的脚本，里面的变量名有些需要修改以适应各自不同的安装环境。

2. 安装GreatSQL并构建MGR集群

2.1 配置Ansible安装剧本

在开始安装前，要先修改 vars.yml 这个Ansbile安装剧本中的几个配置选项：

  1. work_dir: /opt/greatsql/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible
  2. extract_dir: /usr/local
  3. data_dir: /data/GreatSQL
  4. file_name: GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xz
  5. base_dir: /usr/local/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal
  6. my_cnf: /etc/my.cnf
  7. mysql_user: mysql
  8. mysql_port: 3306
  9. mgr_user: GreatSQL
  10. mgr_user_pwd: GreatSQL@2023
  11. mgr_seeds: '172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061'
  12. mgr_single_mode: 1
  13. wait_for_start: 60

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

参数名默认值用途
work_dir/opt/greatsql工作目录，将下载的安装包放在本目录，可根据需要自行调整
extract_dir/usr/localGreatSQL二进制包解压缩后放在 /usr/local下，【不建议调整】
data_dir/data/GreatSQLGreatSQL运行时的datadir，【不建议调整】
file_nameGreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xzGreatSQL二进制包文件名，【不建议调整】
base_dir/usr/local/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimalGreatSQL的basedir，【不建议调整】
my_cnf/etc/my.cnfmy.cnf配置文件路径，【不建议调整】
mysql_usermysql运行GreatSQL对应的user、group，【不建议调整】
mysql_port3306GreatSQL运行时的监听端口，【不建议调整】
mgr_userreplMGR账户
mgr_user_pwdrepl4MGRMGR账户密码
mgr_seeds172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061定义MGR运行时各节点的IP+端口列表，【需要自行调整】
mgr_single_mode是否采用单主模式；0表示否，也就是采用多主模式；1表示是，也就是采用单主模式；默认值：1（即默认采用单主模式）
wait_for_start60初次启动时，要先进行一系列数据文件初始化等工作，后面的MGR初始化工作要等待前面的先完成，如果第一安装失败，可以将这个时间加长

提醒：

  1. 除了修改work_dir和mgr_seeds参数外，其他的都请谨慎修改，否则可能会提示找不到文件目录等错误。
  2. 如果是要采用多主模式，在/etc/ansible/hosts 文件中，把第一个需要初始化引导的节点放在 greatsql_mgr_primary 组里，其他节点照常放在 greatsql_mgr_secondary 组里。

2.2 开始ansible安装

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

  1. $ cd /opt/greatsql/GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal-ansible
  2. $ ls -la
  3. -rw-r--r-- 1 root root      333 Aug  8 11:04 check_mysql.yml
  4. -rw-r--r-- 1 root root 46324036 Aug  8 11:09 GreatSQL-8.0.32-25-Linux-glibc2.17-x86_64-minimal.tar.xz
  5. -rw-r--r-- 1 root root     8920 Aug  8 12:41 greatsql.yml
  6. drwxr-xr-x 3 root root      103 Aug  8 11:07 mysql-support-files
  7. -rw-r--r-- 1 root root      869 Aug  8 11:04 README.en.md
  8. -rw-r--r-- 1 root root      795 Aug  8 11:04 README.md -rw-r--r-- 1 root root      413 Aug  8 14:03 vars.yml
  10. $ ansible-playbook ./greatsql.yml

2.3 检查ansible执行过程输出

安装时会先行检查是否已有mysqld进程在运行，或者3306端口上是否已有其他服务，如果是的话，则输出内容可能会是这样的：

  1. PLAY [install GreatSQL] *****************************************************************************************************************************
  3. TASK [Gathering Facts] ******************************************************************************************************************************
  4. ok: [172.16.16.10]
  5. ok: [172.16.16.11]
  6. ok: [172.16.16.12]
  8. TASK [check mysql port] *****************************************************************************************************************************
  9. changed: [172.16.16.10]
  10. changed: [172.16.16.11]
  11. changed: [172.16.16.12]
  13. TASK [check mysql processor] ************************************************************************************************************************
  14. changed: [172.16.16.10]
  15. changed: [172.16.16.11]
  16. changed: [172.16.16.12]
  18. TASK [modify selinux config file] *******************************************************************************************************************
  19. skipping: [172.16.16.10]
  20. skipping: [172.16.16.11]
  21. skipping: [172.16.16.12]

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

  1. PLAY [install GreatSQL] *****************************************************************************************************************************
  3. TASK [Gathering Facts] ******************************************************************************************************************************
  4. ok: [172.16.16.10]
  5. ok: [172.16.16.11]
  6. ok: [172.16.16.12]
  8. TASK [check mysql port] *****************************************************************************************************************************
  9. changed: [172.16.16.10]
  10. changed: [172.16.16.11]
  11. changed: [172.16.16.12]
  12. ...
  13. PLAY RECAP ******************************************************************************************************************************************
  14. 172.16.16.10               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2
  15. 172.16.16.11               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2
  16. 172.16.16.12               : ok=31   changed=20   unreachable=0    failed=0    skipped=0    rescued=0    ignored=2

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

  1. $ systemctl status greatsql
  2. ● greatsql.service - GreatSQL Server
  3.    Loaded: loaded (/usr/lib/systemd/system/greatsql.service; disabled; vendor preset: disabled)
  4.    Active: active (running) since Tue 2023-08-08 12:26:08 CST; 1h 58min ago
  5.      Docs: man:mysqld(8)
  6.            http://dev.mysql.com/doc/refman/en/using-systemd.html
  7.   Process: 77972 ExecStartPre=/usr/local/GreatSQL-8.0.32-25-Linux-glibc2.28-x86_64-minimal/bin/mysqld_pre_systemd (code=exited, status=0/SUCCESS)
  8.  Main PID: 78043 (mysqld)
  9.    Status: "Server is operational"
  10.     Tasks: 38 (limit: 149064)
  11.    Memory: 367.7M
  12.    CGroup: /system.slice/greatsql.service
  13.            └─78043 /usr/local/GreatSQL-8.0.32-25-Linux-glibc2.28-x86_64-minimal/bin/mysqld
  15. Jul 13 15:46:17 GreatSQL-01 systemd[1]: Starting GreatSQL Server...
  16. Jul 13 15:46:21 GreatSQL-01 systemd[1]: Started GreatSQL Server.

检查MGR服务运行状态：

  1. [root@GreatSQL][(none)]> SELECT * FROM performance_schema.replication_group_members;
  2. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
  3. | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
  4. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
  5. | group_replication_applier | ac24eab8-def4-11eb-a5e8-525400e802e2 | GreatSQL-03 |        3306 | ONLINE       | ARBITRATOR  | 8.0.32        |
  6. | group_replication_applier | ac275d97-def4-11eb-9e49-525400fb993a | GreatSQL-02 |        3306 | ONLINE       | SECONDARY   | 8.0.32        |
  7. | group_replication_applier | ac383458-def4-11eb-bf1a-5254002eb6d6 | GreatSQL-01 |        3306 | ONLINE       | PRIMARY     | 8.0.32        |
  8. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+

至此，安装完成。

问题反馈

联系我们

扫码关注微信公众号

greatsql-wx