InnoDB Cluster 部署

InnoDB Cluster 概述

innodb cluster 是管理 MGR 的一个套件，其中：

• MGR 实现数据同步和选举；
• mysqlshell 用来创建、管理 MGR 集群；
• mysqlrouter 实现业务访问的流量转发，判断 MGR 节点角色 primary or secondary，配置两个端口可以实现读写分离。

架构图：

环境架构：

IP	角色	说明
172.16.22.1	MGR 节点1	单主模式：primary
172.16.22.2	MGR 节点2	单主模式：secondary
172.16.22.3	MGR 节点3	单主模式：secondary
172.16.22.4	mysqlrouter	mysqlrouter 通常建议跟应用部署在同一台机器

1. 安装 mysqlshell

mysqlshell 可以理解为一个 MySQL 客户端工具，它不仅支持 SQL 语言，也支持 JavaScript 和 Python 语言，默认为 JavaScript 语言，可以进行切换。在每个 MySQL 节点服务器上下载 mysqlshell 并解压即可。
使用方式：

mysqlsh root@172.16.22.1:3306

2. 检查节点配置，创建一个管理用户

通过 mysqlsh 连接到各个 MySQL 节点，使用 adminAPI 配置各个实例，如果root 用户无法远程登录，则登录到各个 MySQL 服务器上修改连接信息执行：

JS > dba.configureInstance('root@172.16.22.1:3306',{clusterAdmin: "'mgr_admin'@'%'",clusterAdminPassword:"admin"})
JS > dba.configureInstance('root@172.16.22.2:3306',{clusterAdmin: "'mgr_admin'@'%'",clusterAdminPassword:"admin"})
JS > dba.configureInstance('root@172.16.22.3:3306',{clusterAdmin: "'mgr_admin'@'%'",clusterAdminPassword:"admin"})

这个操作做两件事情：

1. 创建一个管理用户 mgr_admin，并授予必要的权限；
2. 检查 MySQL 参数设置是否符合 MGR 要求。

如果有参数不符合 MGR 要求，会提示，比如：

NOTE: Some configuration options need to be fixed:
+-----------------+---------------+----------------+----------------------------+
| Variable        | Current Value | Required Value | Note                       |
+-----------------+---------------+----------------+----------------------------+
| binlog_checksum | CRC32         | NONE           | Update the server variable |
+-----------------+---------------+----------------+----------------------------+
Do you want to perform the required configuration changes? [y/n]: y
Cluster admin user 'mgr_admin'@'%' created.
Configuring instance...
The instance 'mysql-test3:3306' was configured to be used in an InnoDB cluster.

注意：修改的参数会持久化到 data 目录的 mysqld-auto.conf，接下来创建集群、添加节点的时候也会修改 MySQL 的配置并持久化到mysqld-auto.conf

3. 创建集群

通过 mysqlsh 连接到一个 MySQL 节点，执行创建集群的操作，这个节点会被选为 primary：

JS > dba.createCluster('hucqs_cluster')

创建后查看集群：

JS > var cluster = dba.getCluster()
JS > cluster.status()

{
    "clusterName": "hucqs_cluster",
    "defaultReplicaSet": {
        "name": "default",
        "primary": "mysql-test1:3306",
        "ssl": "REQUIRED",
        "status": "OK_NO_TOLERANCE",
        "statusText": "Cluster is NOT tolerant to any failures.",
        "topology": {
            "mysql-test1:3306": {
                "address": "mysql-test1:3306",
                "mode": "R/W",
                "readReplicas": {},
                "replicationLag": null,
                "role": "HA",
                "status": "ONLINE",
                "version": "8.0.19"
            }
        },
        "topologyMode": "Single-Primary"
    },
    "groupInformationSourceMember": "mysql-test1:3306"
}

4. 添加第二个节点

创建集群后，不要退出登录，直接对集群执行添加节点的操作：

JS > cluster.addInstance("mgr_admin@172.16.22.2:3306")

如果添加的节点 GTID 为空（比如之前做过 reset master），会提示是否自动克隆集群内节点的数据（保证数据一致），如果确定数据此时数据跟其他节点一致，也可以选择只进行增量的组复制，下面示例是选择了增量方式：

OTE: The target instance 'mysql-test2:3306' has not been pre-provisioned (GTID set is empty). The Shell is unable to decide whether incremental state recovery can correctly provision it.
The safest and most convenient way to provision a new instance is through automatic clone provisioning, which will completely overwrite the state of 'mysql-test2:3306' with a physical snapshot from an existing cluster member. To use this method by default, set the 'recoveryMethod' option to 'clone'.

The incremental state recovery may be safely used if you are sure all updates ever executed in the cluster were done with GTIDs enabled, there are no purged transactions and the new instance contains the same GTID set as the cluster or a subset of it. To use this method by default, set the 'recoveryMethod' option to 'incremental'.

Please select a recovery method [C]lone/[I]ncremental recovery/[A]bort (default Clone): I
NOTE: Group Replication will communicate with other members using 'mysql-test2:33061'. Use the localAddress option to override.

5. 添加第三个节点

继续对集群执行添加节点的操作：

JS > cluster.addInstance("mgr_admin@172.16.22.3:3306")

6. 配置 mysqlrouter

在 MySQL 官网下载 mysqlrouter 二进制包，解压后，通过引导模式进行自动配置，有几点说明：

• mysqlrouter 是一个轻量级的中间件，它是无状态的，所以建议和应用部署在一块；
• mysqlrouter 有两种配置方式：
  a. 手工填写后端 MGR 节点的地址，但是这样就没法感知 Primary 节点的变化，手工创建 MGR 时只能这么配置；
  b. 引导模式自动进行配置，通过 mysql_innodb_cluster_metadata 元数据动态感知 Primary 节点的变化，实现对应用的透明，这也是 InnoDB Cluster 的标准配置方法。
  mysqlrouter 必须通过配置两个端口来实现读写分离，没有解析 SQL 的功能。

6.1 创建 mysql 用户

mysqlrouter 引导时必须指定系统用户，并且不能为 root，所以先创建一个系统用户：

useradd mysql

6.2 使用 --bootstrap 参数引导配置 mysqlrouter

mysqlrouter --bootstrap root@172.16.22.1:3306 --directory /data/mysql-router-8.0.19/ --conf-use-sockets --user=mysql --force

如果命令中填写的 URL 不是 Primary 节点地址，会自动尝试连接到 Primary，完成配置，大致会做几件事：

1. 创建一个 mysql_router1_xxx 用户，并授权，用来查询 mysql_innodb_cluster_metadata 元数据，感知 MGR 集群的拓扑变化;
2. 创建配置文件 mysqlrouter.conf.

简单看一段配置文件内容：

[routing:hucq_cluster_rw]
bind_address=0.0.0.0
bind_port=6446
socket=/data/mysql-router-8.0.19/mysql.sock
destinations=metadata-cache://hucq_cluster/?role=PRIMARY
routing_strategy=first-available
protocol=classic

[routing:hucq_cluster_ro]
bind_address=0.0.0.0
bind_port=6447
socket=/data/mysql-router-8.0.19/mysqlro.sock
destinations=metadata-cache://hucq_cluster/?role=SECONDARY
routing_strategy=round-robin-with-fallback
protocol=classic

6.3 启停 mysqlrouter

./start.sh
./stop.sh