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
  5. [greatsql_mgr_primary]
  6. 172.16.16.10
  7. [greatsql_mgr_secondary]
  8. 172.16.16.11
  9. [greatsql_mgr_arbitrator]
  10. 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-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"
  2. $ 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/localGreatSQL二进制包解压缩后放在 /usr/local下,【不建议调整】
data_dir/data/GreatSQLGreatSQL运行时的datadir,【不建议调整】
file_nameGreatSQL-8.0.32-24-Linux-glibc2.17-x86_64-minimal.tar.xzGreatSQL二进制包文件名,【不建议调整】
base_dir/usr/local/GreatSQL-8.0.32-24-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-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
  9. $ ansible-playbook ./greatsql.yml

2.3 检查ansible执行过程输出

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

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

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

  1. PLAY [install GreatSQL] *****************************************************************************************************************************
  2. TASK [Gathering Facts] ******************************************************************************************************************************
  3. ok: [172.16.16.10]
  4. ok: [172.16.16.11]
  5. ok: [172.16.16.12]
  6. TASK [check mysql port] *****************************************************************************************************************************
  7. changed: [172.16.16.10]
  8. changed: [172.16.16.11]
  9. changed: [172.16.16.12]
  10. ...
  11. PLAY RECAP ******************************************************************************************************************************************
  12. 172.16.16.10 : ok=31 changed=20 unreachable=0 failed=0 skipped=0 rescued=0 ignored=2
  13. 172.16.16.11 : ok=31 changed=20 unreachable=0 failed=0 skipped=0 rescued=0 ignored=2
  14. 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
  14. Jul 13 15:46:17 GreatSQL-01 systemd[1]: Starting GreatSQL Server...
  15. 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