容器化安装

本文详细介绍如何在Docker中部署GreatSQL，并且构建一个MGR集群。

1. 安装Docker

直接用yum/dnf安装Docker，非常省事

1. $ yum install -y docker

之后启动 Docker 服务，并设置开机自启动

1. $ systemctl enable docker
2. $ systemctl start docker

2. 拉取GreatSQL镜像，并创建容器

2.1 拉取镜像

拉取GreatSQL官方镜像

1. $ docker pull greatsql/greatsql
2. docker pull greatsql/greatsql
3. Using default tag: latest
4. Trying to pull repository docker.io/greatsql/greatsql ...
5. latest: Pulling from docker.io/greatsql/greatsql
6. ...
7. Digest: sha256:03969daaaaaeb0f51dde0c9e92ef327302607cdde3afbe5c2b071098000c52c1
8. Status: Downloaded newer image for greatsql/greatsql:latest
9. docker.io/greatsql/greatsql:latest

若是arm的架构拉取请使用docker pull greatsql/greatsql:8.0.32-25-aarch64

检查是否成功拉取

1. $ docker images
2. REPOSITORY                    TAG                 IMAGE ID            CREATED             SIZE
3. docker.io/greatsql/greatsql   latest              a930afc72d88        8 weeks ago         923 MB

2.2 创建新容器

之后，就可以直接创建一个新的容器了，先用常规方式

1. $ docker run -d --name greatsql --hostname=greatsql -e MYSQL_ALLOW_EMPTY_PASSWORD=1 greatsql/greatsql

容器的命名和容器内主机名均为greatsql。

确认容器状态：

1. $ docker ps -a | grep greatsql
2. ...
3. 4f351e22cea9   greatsql/greatsql     "/docker-entrypoint.…"   About a minute ago   Up About a minute          3306/tcp, 33060-33061/tcp   greatsql
4. ...

看到容器状态是Up的，表示已正常启动了。

2.3 容器管理

进入容器查看

1. $ docker exec -it greatsql /bin/bash
2. [root@greatsql /]# mysql
3. Welcome to the MySQL monitor.  Commands end with ; or \g.
4. Your MySQL connection id is 12
5. Server version: 8.0.32-25 GreatSQL, Release 25, Revision db07cc5cb73
6. ...
7. Server version:        8.0.32-25 GreatSQL, Release 25, Revision db07cc5cb73
8. ...

10. Threads: 2  Questions: 18  Slow queries: 0  Opens: 119  Flush tables: 3  Open tables: 36  Queries per second avg: 0.243

看到容器已经完成初始化，并且可以直接无密码登入。

3. 利用Docker-compose创建Docker容器并构建MGR集群（单主模式）

手工管理Docker比较麻烦，建议采用 docker-compose ，它可以更方便的管理docker容器。

先用yum安装docker-compose，并确认版本号

1. $ yum install -y docker-compose

3. $ docker-compose --version
4. docker-compose version 1.29.2, build 5becea4c

编辑一个yaml文件，准备部署包含仲裁节点的三节点MGR集群：

1. $ mkdir -p /data/docker-compose
2. $ cat /data/docker-compose/mgr-3nodes.yml
3. version: '2'

5. services:
6. mgr2:
7. image: greatsql/greatsql         #指定镜像
8. container_name: mgr2    #设定容器名字
9. hostname: mgr2          #设定容器中的主机名
10. networks:               #指定容器使用哪个专用网络
11. mgr_net:
12. ipv4_address: 172.18.0.2    #设置容器使用固定IP地址，避免重启后IP变化
13. restart: unless-stopped         #设定重启策略
14. environment:                    #设置多个环境变量
15. TZ: Asia/Shanghai             #时区
16. MYSQL_ALLOW_EMPTY_PASSWORD: 1                 #允许root账户空密码
17. MYSQL_INIT_MGR: 1                             #初始化MGR集群
18. MYSQL_MGR_LOCAL: '172.18.0.2:33061'           #当前MGR节点的local_address
19. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'     #MGR集群seeds
20. MYSQL_MGR_START_AS_PRIMARY: 1                 #指定当前MGR节点为Primary角色
21. MYSQL_MGR_ARBITRATOR: 0
22. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
23. mgr3:
24. image: greatsql/greatsql
25. container_name: mgr3
26. hostname: mgr3
27. networks:
28. mgr_net:
29. ipv4_address: 172.18.0.3
30. restart: unless-stopped
31. depends_on:
32. - "mgr2"
33. environment:
34. TZ: Asia/Shanghai
35. MYSQL_ALLOW_EMPTY_PASSWORD: 1
36. MYSQL_INIT_MGR: 1
37. MYSQL_MGR_LOCAL: '172.18.0.3:33061'
38. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'
39. MYSQL_MGR_START_AS_PRIMARY: 0
40. MYSQL_MGR_ARBITRATOR: 0                       #既非Primary，也非Arbitrator，那么就是Secondary角色了
41. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
42. mgr4:
43. image: greatsql/greatsql
44. container_name: mgr4
45. hostname: mgr4
46. networks:
47. mgr_net:
48. ipv4_address: 172.18.0.4
49. restart: unless-stopped
50. depends_on:
51. - "mgr3"
52. environment:
53. TZ: Asia/Shanghai
54. MYSQL_ALLOW_EMPTY_PASSWORD: 1
55. MYSQL_INIT_MGR: 1
56. MYSQL_MGR_LOCAL: '172.18.0.4:33061'
57. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'
58. MYSQL_MGR_START_AS_PRIMARY: 0
59. MYSQL_MGR_ARBITRATOR: 1                   #指定当前MGR节点为Arbitrator角色，此时不能同时指定其为Primary/Secondary角色
60. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
61. networks:
62. mgr_net:  #创建独立MGR专属网络
63. ipam:
64. config:
65. - subnet: 172.18.0.0/24

关于GreatSQL容器启动选项说明，详见GreatSQL For Docker文档容器化安装 - 图1 (opens new window)。

如果不想要仲裁节点，则可以修改最后一个节点的属性 MYSQL_MGR_ARBITRATOR: 0 就行了。

另外，利用 docker-compose 方式暂时无法构建多主模式的MGR集群，需要手动部署。

启动三个实例：

1. $ docker-compose -f /data/docker-compose/mgr-3nodes.yml up -d
2. Creating network "docker-compose_mgr_net" with the default driver
3. Creating mgr2 ... done
4. Creating mgr3 ... done
5. Creating mgr4 ... done

查看运行状态：

1. $ docker-compose -f /data/docker-compose/mgr-3nodes.yml up -d
2. Name             Command              State               Ports
3. ----------------------------------------------------------------------------
4. mgr2   /docker-entrypoint.sh mysqld   Up      3306/tcp, 33060/tcp, 33061/tcp
5. mgr3   /docker-entrypoint.sh mysqld   Up      3306/tcp, 33060/tcp, 33061/tcp
6. mgr4   /docker-entrypoint.sh mysqld   Up      3306/tcp, 33060/tcp, 33061/tcp

容器刚创建完还需要过一小段时间才能完成GreatSQL的初始化以及MGR集群自动构建，视服务器性能不同而定，一般需要30秒至四分钟左右。

进入被选为PRIMARY节点的容器mgr2，查看MGR集群状态：

1. $ docker exec -it mgr2 bash
2. [root@mgr2 /]# mysql
3. Welcome to the MySQL monitor.  Commands end with ; or \g.
4. Your MySQL connection id is 30
5. Server version: 8.0.32-25 GreatSQL, Release 25, Revision db07cc5cb73
6. ...
7. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

9. (Tue Jul 12 14:28:00 2022)[root@GreatSQL][(none)]> \s
10. --------------
11. mysql  Ver 8.0.32-25 for Linux on x86_64 (GreatSQL, Release 25, Revision db07cc5cb73)
12. ...
13. Uptime:            1 min 38 sec

15. Threads: 11  Questions: 52  Slow queries: 0  Opens: 145  Flush tables: 3  Open tables: 62  Queries per second avg: 0.530
16. --------------

18. (Tue Jul 12 14:28:05 2022)[root@GreatSQL][(none)]> SELECT * FROM performance_schema.replication_group_members;
19. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
20. | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
21. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
22. | group_replication_applier | 396465ad-01ab-11ed-9c1a-0242ac120002 | 172.18.0.2  |        3306 | ONLINE       | PRIMARY     | 8.0.32         |
23. | group_replication_applier | 3a4eabbd-01ab-11ed-a7ea-0242ac120003 | 172.18.0.3  |        3306 | ONLINE       | SECONDARY   | 8.0.32         |
24. | group_replication_applier | 3c707b56-01ab-11ed-969b-0242ac120004 | 172.18.0.4  |        3306 | ONLINE       | ARBITRATOR  | 8.0.32         |
25. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
26. 3 rows in set (0.01 sec)

可以看到，包含仲裁节点的三节点MGR集群已自动构建完毕。

4. 利用Docker-compose创建Docker容器并构建MGR集群（多主模式）

下面是一个docker-compose的配置文件参考 /data/docker/mgr-multi-primary.yml:

1. version: '2'

3. services:
4. mgr2:
5. image: greatsql/greatsql
6. container_name: mgr2    #设定容器名字
7. hostname: mgr2          #设定容器中的主机名
8. networks:               #指定容器使用哪个专用网络
9. mgr_net:
10. ipv4_address: 172.18.0.2    #设置容器使用固定IP地址，避免重启后IP变化
11. restart: unless-stopped         #设定重启策略
12. environment:                    #设置多个环境变量
13. TZ: Asia/Shanghai             #时区
14. MYSQL_ALLOW_EMPTY_PASSWORD: 1                 #允许root账户空密码
15. MYSQL_INIT_MGR: 1                             #初始化MGR集群
16. MYSQL_MGR_LOCAL: '172.18.0.2:33061'           #当前MGR节点的local_address
17. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'     #MGR集群seeds
18. MYSQL_MGR_START_AS_PRIMARY: 1                 #指定当前MGR节点为Primary角色
19. MYSQL_MGR_MULTI_PRIMARY: 1             #指定是否采用多主模式
20. MYSQL_MGR_ARBITRATOR: 0
21. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
22. mgr3:
23. image: greatsql/greatsql
24. container_name: mgr3
25. hostname: mgr3
26. networks:
27. mgr_net:
28. ipv4_address: 172.18.0.3
29. restart: unless-stopped
30. depends_on:
31. - "mgr2"
32. environment:
33. TZ: Asia/Shanghai
34. MYSQL_ALLOW_EMPTY_PASSWORD: 1
35. MYSQL_INIT_MGR: 1
36. MYSQL_MGR_LOCAL: '172.18.0.3:33061'
37. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'
38. MYSQL_MGR_START_AS_PRIMARY: 0
39. MYSQL_MGR_MULTI_PRIMARY: 1
40. MYSQL_MGR_ARBITRATOR: 0                       #既非Primary，也非Arbitrator，那么就是Secondary角色了
41. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
42. mgr4:
43. image: greatsql/greatsql
44. container_name: mgr4
45. hostname: mgr4
46. networks:
47. mgr_net:
48. ipv4_address: 172.18.0.4
49. restart: unless-stopped
50. depends_on:
51. - "mgr3"
52. environment:
53. TZ: Asia/Shanghai
54. MYSQL_ALLOW_EMPTY_PASSWORD: 1
55. MYSQL_INIT_MGR: 1
56. MYSQL_MGR_LOCAL: '172.18.0.4:33061'
57. MYSQL_MGR_SEEDS: '172.18.0.2:33061,172.18.0.3:33061,172.18.0.4:33061'
58. MYSQL_MGR_START_AS_PRIMARY: 0
59. MYSQL_MGR_MULTI_PRIMARY: 1
60. MYSQL_MGR_ARBITRATOR: 0                   #指定当前MGR节点为Arbitrator角色，此时不能同时指定其为Primary/Secondary角色
61. #MYSQL_MGR_VIEWID: "aaaaaaaa-bbbb-bbbb-aaaa-aaaaaaaaaaa1"
62. networks:
63. mgr_net:  #创建独立MGR专属网络
64. ipam:
65. config:
66. - subnet: 172.18.0.0/24

启动所有容器:

1. $ docker-compse -f /data/docker/mgr-multi-primary.yml up -d

容器启动后，会自行进行MySQL实例的初始化并自动构建MGR集群。

进入第一个容器，确认实例启动并成为MGR的Primary节点：

1. $ docker exec -it mgr2 bash
2. $ mysql
3. ...
4. [root@GreatSQL][(none)]> SELECT * FROM performance_schema.replication_group_members;
5. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+----------------------------+
6. | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION | MEMBER_COMMUNICATION_STACK |
7. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+----------------------------+
8. | group_replication_applier | 9831bac0-30d4-11ee-8b65-0242ac120002 | 172.18.0.2  |        3306 | ONLINE       | PRIMARY     | 8.0.32         | XCom                       |
9. | group_replication_applier | 9907b1ae-30d4-11ee-8c66-0242ac120003 | 172.18.0.3  |        3306 | ONLINE       | PRIMARY     | 8.0.32         | XCom                       |
10. | group_replication_applier | 9a1ee7ca-30d4-11ee-8b93-0242ac120004 | 172.18.0.4  |        3306 | ONLINE       | PRIMARY     | 8.0.32         | XCom                       |
11. +---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+----------------------------+

可以看到，一个三节点的MGR集群已自动构建完毕，运行模式为多主模式。

5. Docker-Compose环境变量/参数介绍

  • MYSQL_ROOT_PASSWORD 设置MySQL root账号的密码。如果下面指定了MYSQL_ALLOW_EMPTY_PASSWORD=1，则本参数无效。
  • MYSQL_DATABASE 是否初始化一个新的数据库。
  • MYSQL_ALLOW_EMPTY_PASSWORD 是否设置MySQL root账号使用空密码，因为安全原因，不推荐这么做。
  • MYSQL_RANDOM_ROOT_PASSWORD 设置MySQL root账号的密码采用随机生成方式。
  • MYSQL_IBP 设置innodb_buffer_pool_size，默认值：128M。
  • MYSQL_INIT_MGR 是否初始化MGR相关设置，默认值：0（否）。如果设置为1（是），则会创建MGR服务所需账号，并设定运行 CHANGE MASTER TO 设置好MGR复制通道。 非必选项。
  • MYSQL_MGR_NAME 设置group_replication_group_name，默认值：”aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaa1”。 非必选项。
  • MYSQL_MGR_LOCAL 设置 group_replication_local_address，默认值：”172.17.0.2:33061”。 如果 MYSQL_INIT_MGR=1 则为必选项。
  • MYSQL_MGR_SEEDS 设置 group_replication_group_seeds，默认值：”172.17.0.2:33061,172.17.0.3:33061”。 如果 MYSQL_INIT_MGR=1 则为必选项。
  • MYSQL_MGR_USER 设置MGR服务所需账号，默认值：repl。 非必选项。
  • MYSQL_MGR_USER_PWD 设置MGR服务所需账号的密码，默认值：repl4MGR。 非必选项。
  • MYSQL_SID 设置server_id选项，构建MGR集群时要求每个节点的server_id是唯一的，默认值：3306+随机数 非必选项。
  • MYSQL_MGR_START_AS_PRIMARY 指定当前节点在MGR中以PRIMARY角色启动，每次都会进行MGR初始化引导操作。默认值：0。 如果 MYSQL_INIT_MGR=1 则至少要有一个节点指定为PRIMARY角色。
  • MYSQL_MGR_MULTI_PRIMARY 设置是否采用多主模式运行。默认值：0。 如果 MYSQL_MGR_MULTI_PRIMARY=1，则【有且只能选择一个节点】设置 MYSQL_MGR_START_AS_PRIMARY=1，该节点会采用引导模式启动，其余节点不设置引导模式。
  • MYSQL_MGR_ARBITRATOR 指定当前节点在MGR中以ARBITRATOR角色启动，该选项和MYSQL_MGR_START_AS_PRIMARY是互斥的，不能同时设置为1。默认值：0。 非必选项。
  • MYSQL_MGR_VIEWID MySQL 8.0.26开始，可以为view change单独指定一个GTID前缀，避免和正常的事务GTID混杂一起，产生问题。默认值：AUTOMATIC。 非必选项。

更多关于如何利用Docker/Docker-Compose完成GreatSQL初始化并构建MGR集群的详情请查看 GreatSQL-Docker项目容器化安装 - 图2 (opens new window)。

问题反馈

联系我们

扫码关注微信公众号

greatsql-wx