MySQL8 搭建集群方案文档_mysql8集群搭建

MySQL8.0.21 InnoDB Cluster 从零搭建集群方案详细文档

InnoDB集群
本文档分享新版本MySQL 8.0.21 Innodb Cluster集群搭建过程 ~

MySQL InnoDB Cluster为MySQL提供了完整的高可用性解决方案。通过使用MySQL Shell附带的AdminAPI， 您可以轻松地配置和管理一组至少三个MySQL服务器实例，以充当InnoDB集群。

每个MySQL服务器实例都运行MySQL Group Replication，它提供了具有内置故障转移功能的InnoDB Clusters中复制数据的机制。AdminAPI消除了直接在InnoDB群集中使用组复制的需要。

MySQL路由器可以根据您部署的群集自动进行自我配置，从而将客户端应用程序透明地连接到服务器实例。如果服务器实例发生意外故障，群集将自动重新配置。

在默认的单主服务器模式下，InnoDB集群具有单个读写服务器实例-主服务器。多个辅助服务器实例是主服务器的副本。如果主服务器发生故障，则辅助服务器将自动升级为主服务器角色。MySQL Router会检测到此情况并将客户端应用程序转发到新的主服务器。高级用户还可以将集群配置为具有多个主数据库。

下图概述了这些技术如何协同工作：

图21.1 InnoDB Cluster概述

环境信息

这里准备三台虚拟机就可以了， MySQL Router 和 MySQL Shell 可以和 MySQL Server 部署在同一台服务器上，生产环境，可以根据具体场景对标安装，实验环境参考如下：

安装说明

这里我们先安装 MGR 组复制成功之后， 再安装 MySQL Shell 8.0.21 组件和部署 MySQL Router 8.0.21，即“采用组复制的方式”部署 MySQL InnoDB Cluter 集群。

即先有组复制的存在，然后使用它来创建集群。 后续我们在创建集群的时候，需要将 {adoptFromGR: true} 选项传递 给该 dba.createCluster()功能。创建的InnoDB群集匹配复制组是以单主数据库还是多主数据库运行。

安装顺序： （1）MySQL Server 8.0.21 -> （2）启动MGR组复制 -> （3）MySQL Shell 8.0.21 -> （4）创建 Innodb Cluster 集群 -> （5）MySQL Router 8.0.21

接下来和大家一步步来实现部署上述集群架构。

安装MySQL Server 8.0.21

安装之前，请提前下载好的以上三个软件的二进制安装包，所有安装都采用二进制解压安装即可，如下：

安装MySQL Server用二进制安装即可，这里安装一台，剩下两个节点的安装相同，配置文件要稍加注意一下，比如server id不要重复！部分IP改为节点的IP地址，比如 report_host。

三台机器my.cnf 区别：

#server-id必须是唯一的
server-id = 201
loose-group_replication_local_address = '{IP}:33081'
1
2
3

centos-01 机器 my.cnf 关键的配置如下：

[mysql]
default-character-set=utf8

[mysqld]
datadir=/data/mysql/data
socket=/data/mysql/mysql.sock
pid-file=/data/mysql/mysql.pid
log-error=/data/mysql/log/mysql-err.log

default_authentication_plugin=mysql_native_password
max_connections=200
character-set-server=utf8
default-storage-engine=INNODB
lower_case_table_names=1
max_allowed_packet=16M


#开启GTID,必须开启
gtid_mode=on
#强制GTID的一致性
enforce-gtid-consistency=on
#binlog格式,MGR要求必须是ROW,不过就算不是MGR,也最好用row
binlog_format=row
#server-id必须是唯一的
server-id = 201
#MGR使用乐观锁,所以官网建议隔离级别是RC,减少锁粒度
transaction_isolation = READ-COMMITTED
#因为集群会在故障恢复时互相检查binlog的数据,
#所以需要记录下集群内其他服务器发过来已经执行过的binlog,按GTID来区分是否执行过.
log-slave-updates=on
#binlog校验规则,5.6之后的高版本是CRC32,低版本都是NONE,但是MGR要求使用NONE
binlog_checksum=NONE
#基于安全的考虑,MGR集群要求复制模式要改成slave记录记录到表中,不然就报错
master_info_repository=TABLE
#同上配套
relay_log_info_repository=TABLE
#记录事务的算法,官网建议设置该参数使用 XXHASH64 算法
transaction_write_set_extraction = XXHASH64
#相当于此GROUP的名字,是UUID值,不能和集群内其他GTID值的UUID混用,可用uuidgen来生成一个新的,
#主要是用来区分整个内网里边的各个不同的GROUP,而且也是这个group内的GTID值的UUID
loose-group_replication_group_name = 'b5a9bdff-3c79-4cb4-97a1-e38c45fad878'
#是否随服务器启动而自动启动组复制,不建议直接启动,怕故障恢复时有扰乱数据准确性的特殊情况
loose-group_replication_start_on_boot = OFF
#本地MGR的IP地址和端口，host:port,是MGR的端口,不是数据库的端口
loose-group_replication_local_address = '192.168.1.201:33081'
#需要接受本MGR实例控制的服务器IP地址和端口,是MGR的端口,不是数据库的端口
loose-group_replication_group_seeds = '192.168.1.201:33081,192.168.1.202:33081,192.168.1.203:33081'
#开启引导模式,添加组成员，用于第一次搭建MGR或重建MGR的时候使用,只需要在集群内的其中一台开启,
loose-group_replication_bootstrap_group = OFF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

centos-02 机器 my.cnf 关键的配置如下：

[mysql]
default-character-set=utf8

[mysqld]
datadir=/data/mysql/data
socket=/data/mysql/mysql.sock
pid-file=/data/mysql/mysql.pid
log-error=/data/mysql/log/mysql-err.log

default_authentication_plugin=mysql_native_password
max_connections=200
character-set-server=utf8
default-storage-engine=INNODB
lower_case_table_names=1
max_allowed_packet=16M


#开启GTID,必须开启
gtid_mode=on
#强制GTID的一致性
enforce-gtid-consistency=on
#binlog格式,MGR要求必须是ROW,不过就算不是MGR,也最好用row
binlog_format=row
#server-id必须是唯一的
server-id = 202
#MGR使用乐观锁,所以官网建议隔离级别是RC,减少锁粒度
transaction_isolation = READ-COMMITTED
#因为集群会在故障恢复时互相检查binlog的数据,
#所以需要记录下集群内其他服务器发过来已经执行过的binlog,按GTID来区分是否执行过.
log-slave-updates=on
#binlog校验规则,5.6之后的高版本是CRC32,低版本都是NONE,但是MGR要求使用NONE
binlog_checksum=NONE
#基于安全的考虑,MGR集群要求复制模式要改成slave记录记录到表中,不然就报错
master_info_repository=TABLE
#同上配套
relay_log_info_repository=TABLE
#记录事务的算法,官网建议设置该参数使用 XXHASH64 算法
transaction_write_set_extraction = XXHASH64
#相当于此GROUP的名字,是UUID值,不能和集群内其他GTID值的UUID混用,可用uuidgen来生成一个新的,
#主要是用来区分整个内网里边的各个不同的GROUP,而且也是这个group内的GTID值的UUID
loose-group_replication_group_name = 'b5a9bdff-3c79-4cb4-97a1-e38c45fad878'
#是否随服务器启动而自动启动组复制,不建议直接启动,怕故障恢复时有扰乱数据准确性的特殊情况
loose-group_replication_start_on_boot = OFF
#本地MGR的IP地址和端口，host:port,是MGR的端口,不是数据库的端口
loose-group_replication_local_address = '192.168.1.202:33081'
#需要接受本MGR实例控制的服务器IP地址和端口,是MGR的端口,不是数据库的端口
loose-group_replication_group_seeds = '192.168.1.201:33081,192.168.1.202:33081,192.168.1.203:33081'
#开启引导模式,添加组成员，用于第一次搭建MGR或重建MGR的时候使用,只需要在集群内的其中一台开启,
loose-group_replication_bootstrap_group = OFF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

centos-03 机器 my.cnf 关键的配置如下：

[mysql]
default-character-set=utf8

[mysqld]
datadir=/data/mysql/data
socket=/data/mysql/mysql.sock
pid-file=/data/mysql/mysql.pid
log-error=/data/mysql/log/mysql-err.log

default_authentication_plugin=mysql_native_password
max_connections=200
character-set-server=utf8
default-storage-engine=INNODB
lower_case_table_names=1
max_allowed_packet=16M


#开启GTID,必须开启
gtid_mode=on
#强制GTID的一致性
enforce-gtid-consistency=on
#binlog格式,MGR要求必须是ROW,不过就算不是MGR,也最好用row
binlog_format=row
#server-id必须是唯一的
server-id = 203
#MGR使用乐观锁,所以官网建议隔离级别是RC,减少锁粒度
transaction_isolation = READ-COMMITTED
#因为集群会在故障恢复时互相检查binlog的数据,
#所以需要记录下集群内其他服务器发过来已经执行过的binlog,按GTID来区分是否执行过.
log-slave-updates=on
#binlog校验规则,5.6之后的高版本是CRC32,低版本都是NONE,但是MGR要求使用NONE
binlog_checksum=NONE
#基于安全的考虑,MGR集群要求复制模式要改成slave记录记录到表中,不然就报错
master_info_repository=TABLE
#同上配套
relay_log_info_repository=TABLE
#记录事务的算法,官网建议设置该参数使用 XXHASH64 算法
transaction_write_set_extraction = XXHASH64
#相当于此GROUP的名字,是UUID值,不能和集群内其他GTID值的UUID混用,可用uuidgen来生成一个新的,
#主要是用来区分整个内网里边的各个不同的GROUP,而且也是这个group内的GTID值的UUID
loose-group_replication_group_name = 'b5a9bdff-3c79-4cb4-97a1-e38c45fad878'
#是否随服务器启动而自动启动组复制,不建议直接启动,怕故障恢复时有扰乱数据准确性的特殊情况
loose-group_replication_start_on_boot = OFF
#本地MGR的IP地址和端口，host:port,是MGR的端口,不是数据库的端口
loose-group_replication_local_address = '192.168.1.203:33081'
#需要接受本MGR实例控制的服务器IP地址和端口,是MGR的端口,不是数据库的端口
loose-group_replication_group_seeds = '192.168.1.201:33081,192.168.1.202:33081,192.168.1.203:33081'
#开启引导模式,添加组成员，用于第一次搭建MGR或重建MGR的时候使用,只需要在集群内的其中一台开启,
loose-group_replication_bootstrap_group = OFF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

【注意细节：需要创建mysql用户后， my.cnf 文件中的目录都必须设置文件都是必须mysql:mysql】
创建mysql账号，用于启动mysql进程

root@centos-01 ~# groupadd mysql && useradd -r -g mysql -s /bin/false mysql
root@centos-01 ~# cat /etc/passwd | grep -iw  "mysql"                  
mysql:x:999:30003::/home/mysql:/bin/false
1
2
3

解压软件包，先把软件包上传到 /opt 目录

root@centos-01 ~# cd /opt
root@centos-01 /opt# tar -xvf mysql-8.0.21-linux-glibc2.12-x86_64.tar.xz
root@centos-01 /opt# cp -Rf ./mysql-8.0.21-linux-glibc2.12-x86_64/* /usr/local/mysql/
root@centos-01 /opt# chown -R mysql:mysql /usr/local/mysql/
root@centos-01 /opt# chmod -R 755 /usr/local/mysql/
1
2
3
4
5

创建mysql需要的数据目录

root@centos-01 ~# mkdir -p /data/mysql/{data,binlog,relay}
root@centos-01 ~# chown -R mysql:mysql /data/mysql/{data,binlog,relay}
root@centos-01 ~# chmod -R 750 /data/mysql/
1
2
3

初始化数据库，注意在修改root密码的时候，加上 SET SQL_LOG_BIN=0; … SET SQL_LOG_BIN=1；本次该节点的操作不记录日志，密码填你实际的密码。

root@centos-01 ~# /usr/local/mysql/bin/mysqld --defaults-file=/etc/my.cnf --basedir=/usr/local/mysql --datadir=/data/mysql/data --user=mysql --initialize-insecure
root@centos-01 ~# /usr/local/mysql/support-files/mysql.server start
root@centos-01 ~# /usr/local/mysql/bin/mysql -uroot -S /data/mysql/data/mysql.sock -e "SET SQL_LOG_BIN=0;SET global super_read_only=OFF; SET global read_only=OFF; alter user 'root'@'localhost' password expire never; set password for 'root'@'localhost'='123456';flush privileges; SET SQL_LOG_BIN=1;"

root@centos-01 ~# /usr/local/mysql/bin/mysql -uroot -p -S /data/mysql/mysql.sock
-- 组复制
mysql> INSTALL PLUGIN group_replication SONAME 'group_replication.so';
mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS  WHERE PLUGIN_NAME LIKE '%group_replication%';

# 192.168.1.201/centos-01 
#启动引导,注意,只有这套开启引导,其他两台都请忽略这一步
mysql> SET GLOBAL group_replication_bootstrap_group=ON;
#创建一个用户来做同步的用户,并授权,所有集群内的服务器都需要做
mysql> create user 'repl'@'%' identified by '123456';
mysql> grant REPLICATION SLAVE on *.* to 'repl'@'%' with grant option;
#清空所有旧的GTID信息,避免冲突
mysql> reset master;
#创建同步规则认证信息,就是刚才授权的那个用户,和一般的主从规则写法不太一样
mysql> CHANGE MASTER TO MASTER_USER='repl', MASTER_PASSWORD='123456' FOR CHANNEL 'group_replication_recovery';
#启动MGR
mysql> start group_replication;
#查看是否启动成功,看到online就是成功了
mysql> SELECT * FROM performance_schema.replication_group_members;
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| group_replication_applier | 0f661cfd-76a7-11ec-b9b4-000c2915d830 | 0f661cfd-76a7-11ec-b9b4-000c2915d830      |        3306 | ONLINE       | PRIMARY     | 8.0.21         |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
1 row in set (0.02 sec)
#这个时候,就可以先关闭引导了
mysql> SET GLOBAL group_replication_bootstrap_group=OFF;

#其他机器
# 192.168.1.202/centos-02
#创建一个用户来做同步的用户,并授权,所有集群内的服务器都需要做
mysql> create user 'repl'@'%' identified by '123456';
mysql> grant REPLICATION SLAVE on *.* to 'repl'@'%' with grant option;
#清空所有旧的GTID信息,避免冲突
mysql> reset master;
#创建同步规则认证信息,就是刚才授权的那个用户,和一般的主从规则写法不太一样
mysql> CHANGE MASTER TO MASTER_USER='repl', MASTER_PASSWORD='123456' FOR CHANNEL 'group_replication_recovery';
#启动MGR
mysql> start group_replication;
#查看是否启动成功,看到online就是成功了
mysql> SELECT * FROM performance_schema.replication_group_members;
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| group_replication_applier | 2d2baacd-76b4-11ec-b54a-0050562903f0 | centos-02      |        3306 | ONLINE       | SECONDARY     | 8.0.21         |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
1 row in set (0.02 sec)

# 192.168.1.202/centos-03 配置类似192.168.1.202/centos-02
#查看是否启动成功,看到online就是成功了
mysql> SELECT * FROM performance_schema.replication_group_members;
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| group_replication_applier | 7809356e-76b4-11ec-9963-0050563675af | centos-03      |        3306 | ONLINE       | SECONDARY     | 8.0.21         |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
1 row in set (0.02 sec)

#全部配置完后
mysql> SELECT * FROM performance_schema.replication_group_members;
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
| group_replication_applier | 0f661cfd-76a7-11ec-b9b4-000c2915d830 | centos-01   |        3306 | ONLINE       | PRIMARY     | 8.0.21         |
| group_replication_applier | 2d2baacd-76b4-11ec-b54a-0050562903f0 | centos-02   |        3306 | RECOVERING   | PRIMARY     | 8.0.21         |
| group_replication_applier | 7809356e-76b4-11ec-9963-0050563675af | centos-03   |        3306 | RECOVERING   | PRIMARY     | 8.0.21         |
+---------------------------+--------------------------------------+-------------+-------------+--------------+-------------+----------------+
3 rows in set (0.00 sec)


# 授权远程用户
CREATE USER 'root'@'%' IDENTIFIED BY '123456';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

#为了能够管理群集，必须确保您拥有一个具有所需特权的合适用户。推荐的方法是创建一个管理用户。如果在配置实例时未创建管理用户，请使用以下SQL语句来操作。例如，要创建一个名为的用户icadmin，该用户可以管理分配给变量的InnoDB集群 cluster，参与如下操作：这个步骤可选的，如果你后续想直接通过root账号来创建集群也可以的。
mysql> SET SQL_LOG_BIN=0;
mysql> CREATE USER IF NOT EXISTS `icadmin`@`192.168.1.%` IDENTIFIED BY '123456' PASSWORD EXPIRE NEVER;
mysql> GRANT SELECT, RELOAD, SHUTDOWN, PROCESS, FILE, SUPER, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, CREATE USER ON *.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION;
mysql> GRANT BACKUP_ADMIN,CLONE_ADMIN,PERSIST_RO_VARIABLES_ADMIN,REPLICATION_APPLIER,SYSTEM_VARIABLES_ADMIN ON *.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION;                                                                                             mysql> GRANT INSERT, UPDATE, DELETE ON `mysql`.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION;                                           
mysql> GRANT INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, EVENT, TRIGGER ON `mysql_innodb_cluster_metadata`.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION;
mysql> GRANT INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, EVENT, TRIGGER ON `mysql_innodb_cluster_metadata_bkp`.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION;      
mysql> GRANT INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, EVENT, TRIGGER ON `mysql_innodb_cluster_metadata_previous`.* TO `icadmin`@`192.168.1.%` WITH GRANT OPTION; 
mysql> FLUSH PRIVILEGES;
mysql> SET SQL_LOG_BIN=1;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

至些，MGR三节点组复制安装完毕！

安装MySQL Shell 8.0.21
MySQL Shell是MySQL Server的高级客户端和代码编辑器。除了提供的类似于MySQL的SQL功能外，MySQL Shell还提供JavaScript和Python脚本功能，并包括与MySQL配合使用的API。X DevAPI使您能够使用关系数据和文档数据，AdminAPI使您可以使用InnoDB Cluster。

MySQL Shell提供以下功能。

支持的语言
MySQL Shell处理以JavaScript，Python和SQL编写的代码。根据当前处于活动状态的语言，将任何执行的代码作为这些语言之一进行处理。还有一些特定的MySQL Shell命令（带有前缀）\，使您可以配置MySQL Shell，而与当前选择的语言无关。

交互式代码执行
MySQL Shell提供了一种交互式代码执行模式，您可以在MySQL Shell提示符下键入代码并处理每个输入的语句，并将处理结果打印在屏幕上。如果使用中的终端支持Unicode文本输入。支持彩色端子。

批处理代码执行
除了交互执行代码外，MySQL Shell还可以从不同来源获取代码并进行处理。这种以非交互方式处理代码的方法称为 批处理执行。

支持的API
AdminAPI使您可以管理MySQL实例，使用它们创建InnoDB集群，InnoDB ReplicaSet以及集成MySQL路由器。
当MySQL Shell使用X协议连接到MySQL服务器时，X DevAPI使开发人员可以使用关系数据和文档数据。

X协议支持
MySQL Shell旨在为所有支持X协议的MySQL产品提供集成的命令行客户端。MySQL Shell的开发功能专为使用X协议的会话而设计。MySQL Shell还可以使用经典MySQL协议连接到不支持X协议的MySQL服务器。

还有其它功能，请参阅官方文档…

安装MySQL Shell非常简单，先把软件包上传到/opt目录， 直接解压就行：

root@centos-01 ~# cd /opt/soft
root@centos-01 /opt/soft# tar -zxvf mysql-shell-8.0.21-linux-glibc2.12-x86-64bit.tar.gz 
root@centos-01 /opt/soft# cp -Rf ./mysql-shell-8.0.21-linux-glibc2.12-x86-64bit/* /usr/local/mysqlshell/
root@centos-01 /opt/soft# chown -R mysql:mysql /usr/local/mysqlshell
root@centos-01 /opt/soft# chmod -R 755 /usr/local/mysqlshell
# 设置环境变量
root@centos-01 /opt/soft# echo "export PATH=\$PATH:/usr/local/mysqlshell/bin" >> /etc/profile
root@centos-01 /opt/soft# source /etc/profile 
1
2
3
4
5
6
7
8

三个节点部署操作一样，按上面操作即可！

创建 Innodb Cluster 集群

如果您已经有组复制的现有部署，并且想要使用它来创建群集，请将adoptFromGR选项传递 给该 dba.createCluster()功能。创建的InnoDB群集匹配复制组是以单主数据库还是多主数据库运行。

要采用现有的组复制组，请使用MySQL Shell连接到组成员。执行以下SQL:

mysql-js> var cluster = dba.createCluster('testCluster', {adoptFromGR: true});
A new InnoDB cluster will be created based on the existing replication group on instance '192.168.1.201:3306'.

Creating InnoDB cluster 'testCluster' on '192.168.1.201:3306'...

Adding Seed Instance...
Adding Instance '192.168.1.201:3306'...
Adding Instance '192.168.1.202:3306'...
Adding Instance '192.168.1.203:3306'...
Resetting distributed recovery credentials across the cluster...
Cluster successfully created based on existing replication group.
1
2
3
4
5
6
7
8
9
10
11

检查集群状态：
“status”: “OK” 表示集群状态是正常的
“topologyMode”: “Single-Primary” 表示是单主模式
“mode”: “R/W” 表示可读可写
“mode”: “R/O” 表示只读

/usr/local/mysqlshell/bin/mysqlsh -h centos-01 -P 3306 -uroot -p
MySQL Shell 8.0.21

Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
Other names may be trademarks of their respective owners.

Type '\help' or '\?' for help; '\quit' to exit.
WARNING: Using a password on the command line interface can be insecure.
Creating a session to 'root@centos-01:3306'
Fetching schema names for autocompletion... Press ^C to stop.
Your MySQL connection id is 54
Server version: 8.0.21 MySQL Community Server - GPL
No default schema selected; type \use <schema> to set one.
 MySQL  centos-01:3306 ssl  JS >dba.getCluster().status();
{
    "clusterName": "testCluster", 
    "defaultReplicaSet": {
        "name": "default", 
        "primary": "centos-01:3306", 
        "ssl": "DISABLED", 
        "status": "OK", 
        "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.", 
        "topology": {
            "centos-01:3306": {
                "address": "centos-01:3306", 
                "mode": "R/W", 
                "readReplicas": {}, 
                "replicationLag": null, 
                "role": "HA", 
                "status": "ONLINE", 
                "version": "8.0.21"
            }, 
            "centos-02:3306": {
                "address": "centos-02:3306", 
                "mode": "R/O", 
                "readReplicas": {}, 
                "replicationLag": null, 
                "role": "HA", 
                "status": "ONLINE", 
                "version": "8.0.21"
            }, 
            "centos-03:3306": {
                "address": "centos-03:3306", 
                "mode": "R/O", 
                "readReplicas": {}, 
                "replicationLag": null, 
                "role": "HA", 
                "status": "ONLINE", 
                "version": "8.0.21"
            }
        }, 
        "topologyMode": "Single-Primary"
    }, 
    "groupInformationSourceMember": "centos-01:3306"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

MySQL Router 8.0.21
MySQL Router是InnoDB Cluster的一部分，是轻量级的中间件，可在应用程序与后端MySQL服务器之间提供透明的路由。它可以用于各种用例，例如通过有效地将数据库流量路由到适当的后端MySQL服务器来提供高可用性和可伸缩性。可插拔架构还使开发人员能够针对自定义用例扩展MySQL Router。

强烈建议将MySQL Router 8.0与MySQL Server 8.0和5.7一起使用。

为了获得最佳性能，MySQL路由器通常与使用它的应用程序安装在同一主机上。可能的原因包括：

允许本地UNIX域套接字连接到应用程序，而不是TCP / IP。
减少网络延迟。
为了允许MySQL路由器连接到MySQL而不需要路由器主机的额外帐户，对于专门为应用程序主机创建的MySQL帐户（例如 myapp@198.51.100.45），而不是像myapp @％这样的值 。
通常，应用程序服务器最容易扩展。
您可以在网络上运行多个MySQL Router实例，而无需将MySQL Router隔离到单个计算机上。这是因为MySQL路由器对任何特定的服务器或主机都没有亲和力。

图3.1示例MySQL路由器部署

这里我们通过 Bootstrapping MySQL Router 的方式来安装部署 MySQL Router 8.0.21：

解压软件包：

root@centos-01 ~# cd /opt
root@centos-01 /opt/soft# tar -xvf mysql-router-8.0.21-linux-glibc2.12-x86_64.tar.xz
root@centos-01 /opt/soft# cp -Rf ./mysql-router-8.0.21-linux-glibc2.12-x86_64/* /usr/local/mysqlrouter/
root@centos-01 /opt/soft# chown -R mysql:mysql /usr/local/mysqlrouter
root@centos-01 /opt/soft# chmod -R 755 /usr/local/mysqlrouter
1
2
3
4
5

创建MySQL Router 目录

root@centos-01 ~# mkdir -p /data/mysqlrouter
root@centos-01 /opt/soft# chown -R mysql:mysql /data/mysqlrouter
root@centos-01 /opt/soft# chmod -R 755 /data/mysqlrouter

# 设置环境变量
root@centos-01 /opt/soft# echo "export PATH=\$PATH:/usr/local/mysqlrouter/bin" >> /etc/profile
root@centos-01 /opt/soft# source /etc/profile 
1
2
3
4
5
6
7

bootstrap引导，创建一个独立的MySQL Router实例 --directory选项指定路由目录，–name指定路由器名称，以下例子是一个名为InnoDB的集群 “testCluster” 已经存在。

[root@centos-01 mysqlrouter]# /usr/local/mysqlrouter/bin/mysqlrouter --bootstrap root:123456@192.168.1.201 --directory /data/mysqlrouter --conf-use-sockets --user=mysql --name=mysql_router_13306 --conf-bind-address=192.168.1.201 --account-host="192.168.1.%" 
# Bootstrapping MySQL Router instance at '/data/mysqlrouter'...

- Creating account(s) (only those that are needed, if any)
- Verifying account (using it to run SQL queries that would be run by Router)
- Storing account in keyring
- Adjusting permissions of generated files
- Creating configuration /data/mysqlrouter/mysqlrouter.conf

# MySQL Router 'mysql_router_13306' configured for the InnoDB Cluster 'testCluster'

After this MySQL Router has been started with the generated configuration

    $ /usr/local/mysqlrouter/bin/mysqlrouter -c /data/mysqlrouter/mysqlrouter.conf

the cluster 'testCluster' can be reached by connecting to:

## MySQL Classic protocol

- Read/Write Connections: localhost:6446, /data/mysqlrouter/mysql.sock
- Read/Only Connections:  localhost:6447, /data/mysqlrouter/mysqlro.sock

## MySQL X protocol

- Read/Write Connections: localhost:64460, /data/mysqlrouter/mysqlx.sock
- Read/Only Connections:  localhost:64470, /data/mysqlrouter/mysqlxro.sock
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

引导过程已在mysqlrouter.conf指定的目录中创建了 具有所需文件的文件，结果将向您展示如何启动此MySQL Router实例。生成的MySQL路由器目录类似于：

[root@centos-01 mysqlrouter]# tree /data/mysqlrouter/
/data/mysqlrouter/
├── data
│   ├── keyring
│   └── state.json
├── log
│   └── mysqlrouter.log
├── mysqlrouter.conf
├── mysqlrouter.key
├── run
├── start.sh
└── stop.sh

1
2
3
4
5
6
7
8
9
10
11
12
13

生成的MySQL路由器配置文件（mysqlrouter.conf）类似于：

[root@centos-01 mysqlrouter]# cat mysqlrouter.conf

# File automatically generated during MySQL Router bootstrap
[DEFAULT]
name=mysql_router_13306
user=mysql
logging_folder=/data/mysqlrouter/log
runtime_folder=/data/mysqlrouter/run
data_folder=/data/mysqlrouter/data
keyring_path=/data/mysqlrouter/data/keyring
master_key_path=/data/mysqlrouter/mysqlrouter.key
connect_timeout=15
read_timeout=30
dynamic_state=/data/mysqlrouter/data/state.json

[logger]
level = INFO

[metadata_cache:testCluster]
cluster_type=gr
router_id=3
user=mysql_router3_acli0n74p8oy
metadata_cluster=testCluster
ttl=0.5
auth_cache_ttl=-1
auth_cache_refresh_interval=2
use_gr_notifications=0

[routing:testCluster_rw]
bind_address=192.168.1.201
bind_port=6446
socket=/data/mysqlrouter/mysql.sock
destinations=metadata-cache://testCluster/?role=PRIMARY
routing_strategy=first-available
protocol=classic

[routing:testCluster_ro]
bind_address=192.168.1.201
bind_port=6447
socket=/data/mysqlrouter/mysqlro.sock
destinations=metadata-cache://testCluster/?role=SECONDARY
routing_strategy=round-robin-with-fallback
protocol=classic

[routing:testCluster_x_rw]
bind_address=192.168.1.201
bind_port=64460
socket=/data/mysqlrouter/mysqlx.sock
destinations=metadata-cache://testCluster/?role=PRIMARY
routing_strategy=first-available
protocol=x

[routing:testCluster_x_ro]
bind_address=192.168.1.201
bind_port=64470
socket=/data/mysqlrouter/mysqlxro.sock
destinations=metadata-cache://testCluster/?role=SECONDARY
routing_strategy=round-robin-with-fallback
protocol=x
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

启动MySQL Router 路由器：

[root@centos-01 mysqlrouter]# bash /data/mysqlrouter/start.sh  2>&1 > /dev/null &
[root@centos-01 mysqlrouter]# ps -ef|grep mysql
root       6574      1  0 20:42 pts/0    00:00:00 /bin/sh /usr/local/mysql/bin/mysqld_safe --datadir=/data/mysql/data --pid-file=/data/mysql/mysql.pid
mysql      6967   6574  1 20:42 pts/0    00:01:55 /usr/local/mysql/bin/mysqld --basedir=/usr/local/mysql --datadir=/data/mysql/data --plugin-dir=/usr/local/mysql/lib/plugin --user=mysql --log-error=/data/mysql/log/mysql-err.log --pid-file=/data/mysql/mysql.pid --socket=/data/mysql/mysql.sock
root       7166   1910  0 20:45 pts/0    00:00:00 /usr/local/mysql/bin/mysql -uroot -px xxxx -S /data/mysql/mysql.sock
root      11451   7937  0 22:10 pts/1    00:00:00 /usr/local/mysqlshell/bin/mysqlsh -h centos-01 -P 3306 -uroot -p******
root      12637      1  0 22:35 pts/2    00:00:00 sudo ROUTER_PID=/data/mysqlrouter/mysqlrouter.pid /usr/local/mysqlrouter/bin/mysqlrouter -c /data/mysqlrouter/mysqlrouter.conf --user=mysql
mysql     12638  12637 14 22:35 pts/2    00:00:02 /usr/local/mysqlrouter/bin/mysqlrouter -c /data/mysqlrouter/mysqlrouter.conf --user=mysql
root      12659  10011  0 22:35 pts/2    00:00:00 grep --color=auto mysql

1
2
3
4
5
6
7
8
9
10

Mysql启动命令

## 启动命令：
/usr/local/mysql/support-files/mysql.server start
## 停止命令：
/usr/local/mysql/support-files/mysql.server stop
## 连接客户端命令
/usr/local/mysql/bin/mysql -uroot -p123456 -S /data/mysql/mysql.sock
#201 启动引导
#启动引导,注意,只有这套开启引导,其他两台都请忽略这一步
mysql> SET GLOBAL group_replication_bootstrap_group=ON;
#启动MGR
mysql> start group_replication;
#查看是否启动成功,看到online就是成功了
mysql> SELECT * FROM performance_schema.replication_group_members;
#这个时候,就可以先关闭引导了
mysql> SET GLOBAL group_replication_bootstrap_group=OFF;
#202/203机器
#启动MGR
mysql> start group_replication;
#查看是否启动成功,看到online就是成功了
mysql> SELECT * FROM performance_schema.replication_group_members;

## 启动路由命令
/data/mysqlrouter/start.sh  2>&1 > /dev/null &
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

mysqlsh常用命令 (mysqlsh的JS语法)

dba.checkInstanceConfiguration("root@centos-01:3306")     #检查节点配置实例，用于加入cluster之前
dba.rebootClusterFromCompleteOutage('testCluster');        #重启
dba.dropMetadataSchema();                                #删除schema
var cluster = dba.getCluster('myCluster')                #获取当前集群
cluster.checkInstanceState("root@centos-01:3306")         #检查cluster里节点状态
cluster.rejoinInstance("root@centos-01:3306")             #重新加入节点，我本地测试的时候发现rejoin一直无效，每次是delete后
addcluster.dissolve({force：true})                       #删除集群
cluster.addInstance("root@centos-01:3306")                #增加节点
cluster.removeInstance("root@centos-01:3306")             #删除节点
cluster.removeInstance('root@centos-01:3306',{force:true})    #强制删除节点
cluster.dissolve({force:true})                           #解散集群
cluster.describe();                                      #集群描述
1
2
3
4
5
6
7
8
9
10
11
12