Ansible安装

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。

提醒

请填内网IP地址，因为MGR初始化时，默认使用用内网IP地址。
如果同时还要安装到本机，也请填写内网IP地址。
如果是要采用多主模式，在上面的配置中，把第一个需要初始化引导的节点放在 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-Ansible (opens new window)

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

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

3. $ tar -Jxvf GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal-ansible.tar.xz

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

1. $ cd /opt/greatsql/GreatSQL-8.0.32-24-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-24-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-24-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-24-Linux-glibc2.17-x86_64-minimal-ansible
2. extract_dir: /usr/local
3. data_dir: /data/GreatSQL
4. file_name: GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz
5. base_dir: /usr/local/GreatSQL-8.0.32-24-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/local	GreatSQL二进制包解压缩后放在 /usr/local下，【不建议调整】
data_dir	/data/GreatSQL	GreatSQL运行时的datadir，【不建议调整】
file_name	GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xz	GreatSQL二进制包文件名，【不建议调整】
base_dir	/usr/local/GreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal	GreatSQL的basedir，【不建议调整】
my_cnf	/etc/my.cnf	my.cnf配置文件路径，【不建议调整】
mysql_user	mysql	运行GreatSQL对应的user、group，【不建议调整】
mysql_port	3306	GreatSQL运行时的监听端口，【不建议调整】
mgr_user	repl	MGR账户
mgr_user_pwd	repl4MGR	MGR账户密码
mgr_seeds	172.16.16.10:33061,172.16.16.11:33061,172.16.16.12:33061	定义MGR运行时各节点的IP+端口列表，【需要自行调整】
mgr_single_mode	是否采用单主模式；0表示否，也就是采用多主模式；1表示是，也就是采用单主模式；默认值：1（即默认采用单主模式）
wait_for_start	60	初次启动时，要先进行一系列数据文件初始化等工作，后面的MGR初始化工作要等待前面的先完成，如果第一安装失败，可以将这个时间加长

提醒：

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

2.2 开始ansible安装

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

1. $ cd /opt/greatsql/GreatSQL-8.0.32-24-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-24-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-24-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-24-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. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+

至此，安装完成。

问题反馈

问题反馈 gitee (opens new window)

联系我们

扫码关注微信公众号