MySQL :: MySQL Shell 8.4 :: 8.4 部署 InnoDB ClusterSet

版本 8.4

9.0
8.0

MySQL Shell 8.4 / MySQL InnoDB ClusterSet / 部署 InnoDB ClusterSet

8.4 部署 InnoDB ClusterSet

8.4.1 异步复制通道选项

请按照以下步骤部署沙盒或生产 InnoDB ClusterSet 部署。沙盒部署是指所有 MySQL 服务器实例和其他软件都在一台机器上运行。对于生产部署，服务器实例和其他软件位于不同的机器上。

该过程假定您已经拥有以下组件，如第 8.1 节 “InnoDB ClusterSet 要求” 中所列：

一个满足第 8.1 节 “InnoDB ClusterSet 要求” 中所述要求的现有 InnoDB Cluster。这是 InnoDB ClusterSet 部署支持的主集群。
连接到现有 InnoDB Cluster 的 MySQL Shell。部署过程中使用 MySQL Shell 的 AdminAPI 命令。
MySQL Router，用于引导 InnoDB ClusterSet。您已针对现有 InnoDB Cluster 引导的 MySQL Router 实例可以在 InnoDB ClusterSet 部署中重复使用，但您需要再次引导它们以实现 InnoDB ClusterSet 配置。
多个独立的 MySQL 服务器实例（不属于 InnoDB Cluster 或 InnoDB ReplicaSet），用于组成一个或多个副本集群。它们必须满足第 8.1 节 “InnoDB ClusterSet 要求” 中所述的要求。建议每个副本集群至少包含三个成员服务器，以提高容错能力。

您在 InnoDB ClusterSet 部署过程中使用的用户帐户是主集群中的 InnoDB Cluster 服务器配置帐户。这是使用带有 clusterAdmin 选项的 dba.configureInstance() 命令在主集群的成员服务器上创建的帐户。每个成员服务器只有一个服务器配置帐户。集群中的每个成员服务器上必须使用相同的用户帐户名和密码，并且您需要在 InnoDB ClusterSet 部署中的所有服务器上创建它。可以使用 root 帐户作为 InnoDB Cluster 服务器配置帐户，但不建议这样做，因为这意味着集群中每个成员服务器上的 root 帐户必须具有相同的密码。有关更多信息，请参阅第 8.3 节 “InnoDB ClusterSet 的用户帐户”。

要设置 InnoDB ClusterSet 部署，请按照以下步骤操作：

使用 InnoDB Cluster 服务器配置帐户连接到现有 InnoDB Cluster 中的任何成员服务器，以建立连接。例如：

mysql-js> \connect [email protected]:3310

Creating a session to '[email protected]:3310'
Please provide the password for '[email protected]:3310': **************
Save password for '[email protected]:3310'? [Y]es/[N]o/Ne[v]er (default No):
Fetching schema names for autocompletion... Press ^C to stop.
Closing old connection...
Your MySQL connection id is 59
Server version: 8.0.27-commercial MySQL Enterprise Server - Commercial
No default schema selected; type \use <schema> to set one.
<ClassicSession:[email protected]:3310>

在此示例中：

icadmin@127.0.0.1:3310 是 InnoDB Cluster 中任何在线成员服务器实例的 URI 类连接字符串。

URI 类连接字符串由以下元素组成：
icadmin 是 InnoDB Cluster 服务器配置帐户的用户名。
127.0.0.1:3310 是成员服务器实例的主机和端口，如 cluster.status() 命令所示。

发出 dba.getCluster() 命令以获取表示 InnoDB Cluster 的 Cluster 对象，并将其分配给一个变量，以便您可以使用它。例如：
```
mysql-js> cluster1 = dba.getCluster()
<Cluster:clusterone>
```
在此示例中，clusterone 是现有 InnoDB Cluster 的名称，如 cluster.status() 命令返回的 clusterName 字段所示，返回的 Cluster 对象分配给变量 cluster1。

当您使用 InnoDB Cluster 服务器配置帐户连接到服务器实例时，执行此操作非常重要。返回的对象默认使用获取它的帐户来执行需要权限的操作。InnoDB ClusterSet 部署过程中的某些操作需要权限，为此使用存储在对象中的默认用户帐户，这样该过程就不需要存储任何其他用户帐户。
使用 Cluster 对象发出 cluster.createClusterSet() 命令，以创建以现有 InnoDB Cluster 作为主集群的 InnoDB ClusterSet。例如：
```
mysql-js> myclusterset = cluster1.createClusterSet('testclusterset')

A new ClusterSet will be created based on the Cluster 'clusterone'.

* Validating Cluster 'clusterone' for ClusterSet compliance.

* Creating InnoDB ClusterSet 'testclusterset' on 'clusterone'...

* Updating metadata...

ClusterSet successfully created. Use ClusterSet.createReplicaCluster() to add Replica Clusters to it.

<ClusterSet:testclusterset>
```
在此示例中，clusterone 是现有 InnoDB Cluster 的名称，cluster1 是分配了返回的 Cluster 对象的变量，testclusterset 是您要创建的 InnoDB ClusterSet 的名称，myclusterset 是分配了返回的 ClusterSet 对象的变量。
- domainName 参数是必需的，用于指定您要创建的 InnoDB ClusterSet 部署的名称（示例中为 testclusterset）。
  
  domainName 不能为空，并且长度不能超过 63 个字符。它只能以字母数字字符或 _（下划线）开头，并且只能包含字母数字、_（下划线）、.（句点）或 -（连字符）字符。
- 如果您想执行验证并记录更改而不实际执行它们，请使用 dryRun 选项。例如：
```
mysql-js> myclusterset = cluster1.createClusterSet('testclusterset', {dryRun: true})
* Validating Cluster 'clusterone' for ClusterSet compliance.

NOTE: dryRun option was specified. Validations will be executed, but no changes will be applied.
* Creating InnoDB ClusterSet 'clusterset' on 'clusterone'...

* Updating metadata...
dryRun finished.
```
- 如果您想要求或禁用 InnoDB ClusterSet 部署中复制通道的加密（TLS/SSL），请使用 clusterSetReplicationSslMode 选项。默认设置 AUTO 在服务器实例支持加密时启用加密，在服务器实例不支持加密时禁用加密。REQUIRED 为所有复制通道启用加密，DISABLED 为所有复制通道禁用加密。例如：
```
mysql-js> myclusterset = cluster1.createClusterSet("testclusterset", {clusterSetReplicationSslMode: 'REQUIRED'})
```
clusterSetReplicationSslMode 支持 VERIFY_CA 和 VERIFY_IDENTITY。例如：
```
mysql-js> myclusterset = cluster.createClusterSet("testclusterset", {"clusterSetReplicationSslMode":"VERIFY_IDENTITY"});
```
当您发出 cluster.createClusterSet() 命令时，MySQL Shell 会检查目标 InnoDB Cluster 是否符合成为 InnoDB ClusterSet 部署中的主集群的要求，如果不符合，则返回错误。如果目标 InnoDB Cluster 满足要求，MySQL Shell 将执行以下设置任务：
- 更新元数据架构以包含 InnoDB ClusterSet 元数据。
- 在所有成员服务器上将 skip_replica_start 系统变量设置为 ON，以便不自动启动复制线程。
- 将目标 InnoDB Cluster 添加到元数据中的 InnoDB ClusterSet，并将其标记为主集群。
- 返回表示 InnoDB ClusterSet 的 ClusterSet 对象。

通过使用返回的 ClusterSet 对象发出 clusterSet.status() 命令来验证您创建的 InnoDB ClusterSet 部署是否正常。例如：

mysql-js> myclusterset.status()
{
    "clusters": {
        "clusterone": {
            "clusterRole": "PRIMARY",
            "globalStatus": "OK",
            "primary": "127.0.0.1:3310"
        }
    },
    "domainName": "testclusterset",
    "globalPrimaryInstance": "127.0.0.1:3310",
    "primaryCluster": "clusterone",
    "status": "HEALTHY",
    "statusText": "All Clusters available."
}

您还可以使用 cluster.status() 命令查看集群本身。或者，您可以为 clusterSet.status() 选择扩展输出，以查看 InnoDB ClusterSet 拓扑中集群的详细状态。例如：

mysql-js> myclusterset.status({extended: 1})
{
    "clusters": {
        "clusterone": {
            "clusterRole": "PRIMARY",
            "globalStatus": "OK",
            "primary": "127.0.0.1:3310",
            "status": "OK",
            "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.",
            "topology": {
                "127.0.0.1:3310": {
                    "address": "127.0.0.1:3310",
                    "memberRole": "PRIMARY",
                    "mode": "R/W",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:3320": {
                    "address": "127.0.0.1:3320",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:3330": {
                    "address": "127.0.0.1:3330",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                }
            },
            "transactionSet": "953a51d5-2690-11ec-ba07-00059a3c7a00:1,c51c1b15-269e-11ec-b9ba-00059a3c7a00:1-86,c51c29ad-269e-11ec-b9ba-00059a3c7a00:1-8"
        }
    },
    "domainName": "testclusterset",
    "globalPrimaryInstance": "127.0.0.1:3310",
    "metadataServer": "127.0.0.1:3310",
    "primaryCluster": "clusterone",
    "status": "HEALTHY",
    "statusText": "All Clusters available."
}

有关更多信息以及 clusterSet.status() 命令的输出说明，请参阅第 8.6 节 “InnoDB ClusterSet 状态和拓扑”。

如果您想随时获取表示已连接服务器实例的 InnoDB ClusterSet 的 ClusterSet 对象（例如，在重新启动 MySQL Shell 之后），请使用 dba.getClusterSet() 或 cluster.getClusterSet() 命令。例如：

mysql-js> myclusterset = dba.getClusterSet()
<ClusterSet:testclusterset>

将返回的 Cluster 或 ClusterSet 对象分配给一个变量，您可以使用该对象的方法对集群或 ClusterSet 执行进一步的操作。返回的对象使用一个新会话，该会话独立于 MySQL Shell 的全局会话。这确保了如果您更改 MySQL Shell 全局会话，Cluster 或 ClusterSet 对象会维护其与服务器实例的会话。请注意，当您使用该对象时，您从中获取该对象的服务器实例必须仍在 InnoDB ClusterSet 中处于联机状态。如果该服务器实例脱机，则该对象将不再起作用，您将需要从仍在联机状态的服务器重新获取它。

通过使用带有 clusterAdmin 选项的 dba.configureInstance() 命令，在将成为副本集群一部分的每个独立服务器实例上创建 InnoDB Cluster 服务器配置帐户。要创建的帐户是您用于创建 ClusterSet 的主集群中的 InnoDB Cluster 服务器配置帐户。不要指定任何 InnoDB Cluster 管理员帐户（使用 cluster.setupAdminAccount() 创建）。这些帐户将在配置过程中自动从主集群传输到副本集群。

您无需事先连接到独立服务器实例，因为连接字符串包含在命令中。在连接字符串中，使用具有完整 MySQL 管理员权限的帐户，包括创建帐户的权限 (WITH GRANT OPTION)。在此示例中，使用的是 root 帐户：
```
mysql-js> dba.configureInstance('[email protected]:4410', {clusterAdmin: 'icadmin'}) 

Please provide the password for '[email protected]:4410': ***************
Save password for '[email protected]:4410'? [Y]es/[N]o/Ne[v]er (default No):
Configuring local MySQL instance listening at port 4410 for use in an InnoDB cluster...
NOTE: Instance detected as a sandbox.
Please note that sandbox instances are only suitable for deploying test clusters for use within
the same host.

This instance reports its own address as 127.0.0.1:4410
Password for new account: **************
Confirm password: **************

applierWorkerThreads will be set to the default value of 4.

The instance '127.0.0.1:4410' is valid to be used in an InnoDB cluster.

Cluster admin user 'icadmin' created.
The instance '127.0.0.1:4410' is already ready to be used in an InnoDB cluster.

Successfully enabled parallel appliers.
```
在本例中，root@127.0.0.1:4410 是独立服务器的类似 URI 的连接字符串，icadmin 是将在实例上创建的 InnoDB Cluster 服务器配置帐户的用户名。为了提高安全性，请在交互式提示符下指定 InnoDB Cluster 服务器配置帐户的密码，如示例所示，或者您可以使用 clusterAdminPassword 选项提供密码。dba.configureInstance() 命令会自动授予帐户所需的权限，但如果您愿意，也可以手动设置帐户，并授予它手动配置 InnoDB Cluster 管理员帐户中列出的权限。有关 dba.configureInstance() 命令及其选项的更多详细信息，请参阅第 7.4.2 节“为 InnoDB Cluster 使用配置生产实例”。

当您发出 dba.configureInstance() 时，MySQL Shell 会验证服务器实例是否满足与 InnoDB Cluster 一起使用的要求。当您发出创建副本集群并将实例添加到其中的命令时，将检查 InnoDB ClusterSet 的要求。
使用 InnoDB Cluster 服务器配置帐户连接到 InnoDB ClusterSet 部署中已存在的主集群中的任何活动实例。确保您仍然拥有在创建 InnoDB ClusterSet 时返回的 ClusterSet 对象，或者使用 dba.getClusterSet() 或 cluster.getClusterSet() 再次获取它。同样，在使用 InnoDB Cluster 服务器配置帐户连接到服务器实例时执行此操作非常重要。无论您在连接上指定哪个帐户，存储在对象中的默认用户帐户都将在 InnoDB ClusterSet 部署过程中用于某些操作。
使用 ClusterSet 对象发出 clusterSet.createReplicaCluster() 命令以创建副本集群，并命名其中一个独立服务器实例。此服务器实例将成为副本集群的主实例。该命令返回副本集群的 Cluster 对象，如果需要，您可以将其分配给变量。例如
```
mysql-js> cluster2 = myclusterset.createReplicaCluster("127.0.0.1:4410", "clustertwo", {recoveryProgress: 1, timeout: 10}) 
Setting up replica 'clustertwo' of cluster 'clusterone' at instance '127.0.0.1:4410'.

A new InnoDB cluster will be created on instance '127.0.0.1:4410'.

Validating instance configuration at 127.0.0.1:4410...
NOTE: Instance detected as a sandbox.
Please note that sandbox instances are only suitable for deploying test clusters for use within 
the same host.

This instance reports its own address as 127.0.0.1:4410

Instance configuration is suitable.
NOTE: Group Replication will communicate with other members using '127.0.0.1:44101'. Use the 
localAddress option to override.


* Checking transaction state of the instance...

NOTE: The target instance '127.0.0.1:4410' has not been pre-provisioned (GTID set is empty). The 
Shell is unable to decide whether replication can completely recover its state.
The safest and most convenient way to provision a new instance is through automatic clone 
provisioning, which will completely overwrite the state of '127.0.0.1:4410' with a physical 
snapshot from an existing clusterset member. To use this method by default, set the 
'recoveryMethod' option to 'clone'.

WARNING: It should be safe to rely on replication to incrementally recover the state of the new 
Replica Cluster if you are sure all updates ever executed in the ClusterSet were done with GTIDs 
enabled, there are no purged transactions and the instance used to create the new Replica Cluster 
contains the same GTID set as the ClusterSet 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):
Waiting for clone process of the new member to complete. Press ^C to abort the operation.
* Waiting for clone to finish...
NOTE: 127.0.0.1:4410 is being cloned from 127.0.0.1:3310
** Stage DROP DATA: Completed

NOTE: 127.0.0.1:4410 is shutting down...

* Waiting for server restart... ready 
* 127.0.0.1:4410 has restarted, waiting for clone to finish...
** Stage FILE COPY: Completed
** Stage PAGE COPY: Completed
** Stage REDO COPY: Completed
** Stage FILE SYNC: Completed
** Stage RESTART: Completed
* Clone process has finished: 72.61 MB transferred in about 1 second (~72.61 MB/s)

Creating InnoDB cluster 'clustertwo' on '127.0.0.1:4410'...

Adding Seed Instance...
Cluster successfully created. Use Cluster.addInstance() to add MySQL instances.
At least 3 instances are needed for the cluster to be able to withstand up to
one server failure.

* Configuring ClusterSet managed replication channel...
** Changing replication source of 127.0.0.1:4410 to 127.0.0.1:3310

* Waiting for instance to synchronize with PRIMARY Cluster...
** Transactions replicated  ############################################################  100%
* Updating topology

Replica Cluster 'clustertwo' successfully created on ClusterSet 'testclusterset'.

<Cluster:clustertwo>
```
对于 clusterSet.createReplicaCluster() 命令
- instance 参数是必需的，用于指定独立服务器的 MySQL Server 实例的主机和端口号。这将成为副本集群主实例的服务器实例。在上面的示例命令中，它是 127.0.0.1:4410。
- clusterName 参数是必需的，用于指定副本集群的标识符。在上面的示例命令中，使用的是 clustertwo。该名称在 InnoDB ClusterSet 中必须是唯一的，并且必须遵循 InnoDB Cluster 命名要求。只能使用字母数字字符、连字符 (-)、下划线 (_) 和句点 (.)，并且名称不能以数字开头。最大长度为 63 个字符。集群名称区分大小写。
- 如果您想执行验证并记录更改而不实际执行它们，请使用 dryRun 选项。
- 如果您想选择一种配置方法，请使用 recoveryMethod 选项。如果您没有将其指定为选项，则使用默认设置 AUTO。在这种情况下，该函数会将服务器实例上的 GTID 集与主集群上的 GTID 集进行比较，并尝试确定最合适的配置方法。如果无法确定，该函数会提示您选择一种配置方法，或者如果您不在交互模式下，则会取消操作。
  
  配置过程（称为分布式恢复）可以使用克隆，其中服务器实例的状态将被从集群中现有成员服务器获取的物理快照完全覆盖。要提前选择此项，请指定 CLONE 设置。另一种方法是从现有成员服务器的二进制日志（在本例中为主集群的成员）进行增量状态传输。在这里，服务器实例接收并应用它尚不具备的来自主集群的事务。要提前选择此项，请指定 INCREMENTAL 设置。
- 如果您想选择一个特定的服务器来提供覆盖当前服务器的快照（如果分布式恢复是通过克隆执行的），请使用 cloneDonor 选项。默认情况下，该操作会选择主集群的辅助成员，如果没有辅助成员，则选择主成员。所选服务器实例必须是 InnoDB ClusterSet 中主集群的成员。指定主机和端口号。此选项不支持 IPv6 地址。
- 使用 recoveryProgress 选项指定分布式恢复过程的详细级别（0、1 或 2）。设置为 0 表示不显示进度信息，设置为 1 表示显示详细的静态进度信息，设置为 2 表示使用进度条显示详细的动态进度信息。如果标准输出是终端，则默认为 2，否则默认为 1。
- 如果您想设置一个超时时间，以便在服务器实例配置完毕并建立 ClusterSet 复制通道后等待服务器实例与主集群同步，请使用 timeout 选项。默认情况下没有超时。
- 使用 manualStartOnBoot 选项指定组复制是在 MySQL 服务器启动时自动启动并重新加入集群，还是必须手动启动。默认值为 false，表示组复制自动启动。
- 使用 communicationStack 选项定义成员之间如何使用 XCOM 或 MYSQL 协议进行通信。请参阅第 7.5.9 节“配置组复制通信堆栈”。
  
  如果您使用的是 MySQL 8.0.27 或更高版本，则默认（也是推荐）的协议是 MYSQL。
- 如果您想为副本 InnoDB Cluster 配置组复制的设置，可以使用 memberSslMode、ipAllowlist、localAddress、exitStateAction、memberWeight、consistency、expelTimeout 和 autoRejoinTries 选项。这些选项的工作方式与非 ClusterSet 一部分的 InnoDB Cluster 相同。有关这些选项的详细信息，请参阅第 7.5 节“配置 InnoDB Cluster”。（注意：ipAllowlist 和 localAddress 仅适用于 XCOM 通信堆栈。）
- 可以使用 localAddress 和 groupName 选项来设置组复制本地地址和组标识符。但是，不建议这样做，因为错误的值会导致组复制出错。仅当您在 InnoDB ClusterSet 设置过程中为这些项目选择的值出现问题时，才使用这些选项。
- 创建 InnoDB ClusterSet 时，如果您有安全要求，要求 AdminAPI 自动创建的所有帐户都具有严格的身份验证要求，则可以为 ClusterSet 的 replicationAllowedHost 配置选项设置一个值。MySQL Shell 选项 replicationAllowedHost 允许您将 ClusterSet 的内部管理复制帐户设置为基于严格子网的过滤器，而不是默认的通配符值 %。replicationAllowedHost 选项采用字符串值。例如，要创建一个名为 my_clusterset_domain 的集群集并将 replicationAllowedHost 选项设置为 192.0.2.0/24，请发出
```
mysql-js> <Cluster>.createClusterSet('my_clusterset_domain', {replicationAllowedHost:'192.0.2.0/24'})
```
  如果您更改了 ClusterSet 上的 replicationAllowedHost，则用于集群之间复制通道的帐户将更改为仅允许来自您为 replicationAllowedHost 指定的值的连接。该主机必须在主集群和副本集群中都可访问。否则，集群之间不会进行复制。
  
  创建后，可以修改 ClusterSet 以设置 replicationAllowedHost，方法是发出
```
mysql-js> <Clusterset>.setOption('replicationAllowedHost','192.0.2.0/24')
```
当您发出 clusterSet.createReplicaCluster() 命令时，MySQL Shell 会检查目标服务器实例是否符合成为 InnoDB ClusterSet 部署中副本 InnoDB Cluster 中主服务器的要求，如果不符合，则返回错误。如果实例满足要求，MySQL Shell 将执行以下设置任务
- 创建 ClusterSet 复制通道 clusterset_replication，并创建一个具有随机密码的复制用户。这是目标实例与主集群的主服务器之间的异步复制通道，由 InnoDB ClusterSet 管理。根据 InnoDB ClusterSet 的 clusterSetReplicationSslMode 选项为通道配置加密。MySQL Shell 会验证复制设置是否正常工作，如果不是，则返回错误。
- 使用选定的恢复方法，使用来自主 InnoDB Cluster 的数据集配置 MySQL Server 实例并同步 GTID 集。请注意，如果 ClusterSet 的成员服务器中有大量数据，分布式恢复可能需要几个小时。
- 在服务器实例上添加 InnoDB Cluster 管理员帐户和 MySQL Router 管理员帐户。如果实例是通过从二进制日志传输状态来配置的，则配置过程包括创建帐户的事务，否则帐户将在克隆期间传输。无论哪种方式，这些帐户都将在服务器实例上可用。有关更多信息，请参阅第 8.3 节“InnoDB ClusterSet 的用户帐户”。
- 为副本集群配置并启动组复制。InnoDB ClusterSet 副本集群创建过程会覆盖任何现有的持久化组复制配置选项，您可以在 clusterSet.createReplicaCluster() 命令上为其指定新设置。它还会始终覆盖以下配置选项，即使您没有在命令中指定它们：group_replication_group_name、group_replication_group_seeds、group_replication_local_address、group_replication_view_change_uuid（仅限版本 8.0.27 至 8.2.0）和 group_replication_enforce_update_everywhere_checks。但是，在将其用于副本集群之前，您在服务器实例上更改的任何其他组复制配置选项都将保留原样。请参阅第 8.1 节“InnoDB ClusterSet 要求”中有关此内容的重要说明。
- 将 skip_replica_start 系统变量设置为 ON，以便不在服务器上自动启动复制线程，并设置 super_read_only 系统变量，以便客户端无法将事务写入服务器。
- 禁用组复制成员操作 mysql_disable_super_read_only_if_primary，以便在视图更改后，super_read_only 在集群的主实例上保持设置。
- 启用组复制成员操作 mysql_start_failover_channels_if_primary，以便为 ClusterSet 复制通道启用副本的异步连接故障转移。启用此功能后，如果正在复制的主服务器脱机或进入错误状态，则新主服务器在被选举出来后将在同一通道上启动复制。
- 将 ClusterSet 元数据传输到服务器实例，在 InnoDB ClusterSet 中创建副本集群，并将目标服务器实例作为主服务器添加到其中。
- 返回副本集群的 Cluster 对象。

使用 clusterSet.createReplicaCluster() 为副本集群返回的 Cluster 对象，发出一个 cluster.addInstance 命令，命名另一个独立服务器实例。此服务器实例将是副本集群中的辅助服务器。例如：

mysql-js> cluster2.addInstance('[email protected]:4420') 

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

Please select a recovery method [C]lone/[A]bort (default Clone): c
Validating instance configuration at localhost:4420...
NOTE: Instance detected as a sandbox.
Please note that sandbox instances are only suitable for deploying test clusters for use within 
the same host.

This instance reports its own address as 127.0.0.1:4420

Instance configuration is suitable.
NOTE: Group Replication will communicate with other members using '127.0.0.1:44201'. Use the 
localAddress option to override.

A new instance will be added to the InnoDB cluster. Depending on the amount of
data on the cluster this might take from a few seconds to several hours.

Adding instance to the cluster...

* Waiting for the Cluster to synchronize with the PRIMARY Cluster...
** Transactions replicated  ############################################################  100% 
* Configuring ClusterSet managed replication channel...
** Changing replication source of 127.0.0.1:4420 to 127.0.0.1:3310

Monitoring recovery process of the new cluster member. Press ^C to stop monitoring and 
let it continue in background.
Clone based state recovery is now in progress.

NOTE: A server restart is expected to happen as part of the clone process. If the
server does not support the RESTART command or does not come back after a
while, you may need to manually start it back.

* Waiting for clone to finish...
NOTE: 127.0.0.1:4420 is being cloned from 127.0.0.1:4410
** Stage DROP DATA: Completed
** Clone Transfer
    FILE COPY  ############################################################  100%  Completed
    PAGE COPY  ############################################################  100%  Completed
    REDO COPY  ############################################################  100%  Completed

NOTE: 127.0.0.1:4420 is shutting down...

* Waiting for server restart... ready
* 127.0.0.1:4420 has restarted, waiting for clone to finish...
** Stage RESTART: Completed
* Clone process has finished: 72.61 MB transferred in about 1 second (~72.61 MB/s)

State recovery already finished for '127.0.0.1:4420'

The instance '127.0.0.1:4420' was successfully added to the cluster.

有关 cluster.addInstance 命令的更多详细信息，请参阅第 7.4.4 节“向 InnoDB 集群添加实例”。

如果需要再次获取副本集群的 Cluster 对象，请使用 InnoDB 集群服务器配置帐户连接到副本集群中的任何活动实例，并发出 dba.getCluster() 命令。此帐户用于设置过程中的某些操作。如果设置过程发现独立服务器实例上不存在该帐户，则会返回错误，您需要发出 dba.configureInstance() 来创建该帐户。

命令成功后，服务器实例将添加到副本集群，并使用 InnoDB ClusterSet 的数据进行配置。克隆操作的源将来自副本集群，而不是主集群。

重复 cluster.addInstance 操作，将所有独立服务器实例添加到副本集群。建议至少使用三个实例来容忍故障。副本集群中最多可以有九个成员服务器，这是底层组复制技术内置的限制。

验证已完成的副本集群和 InnoDB ClusterSet 部署是否正常。您可以使用 cluster.status() 命令查看副本集群，并使用 clusterSet.status() 命令查看 InnoDB ClusterSet 部署。或者，您可以为 clusterSet.status() 选择扩展输出，以查看所有集群的详细状态。例如：

mysql-js> myclusterset.status({extended: 1}) 
{
    "clusters": {
        "clusterone": {
            "clusterRole": "PRIMARY",
            "globalStatus": "OK",
            "primary": "127.0.0.1:3310",
            "status": "OK",
            "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.",
            "topology": {
                "127.0.0.1:3310": {
                    "address": "127.0.0.1:3310",
                    "memberRole": "PRIMARY",
                    "mode": "R/W",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:3320": {
                    "address": "127.0.0.1:3320",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:3330": {
                    "address": "127.0.0.1:3330",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                }
            },
            "transactionSet": "953a51d5-2690-11ec-ba07-00059a3c7a00:1,c51c1b15-269e-11ec-b9ba-00059a3c7a00:1-131,c51c29ad-269e-11ec-b9ba-00059a3c7a00:1-8"
        },
        "clustertwo": {
            "clusterRole": "REPLICA",
            "clusterSetReplication": {
                "applierStatus": "APPLIED_ALL",
                "applierThreadState": "Waiting for an event from Coordinator",
                "applierWorkerThreads": 4,
                "receiver": "127.0.0.1:4410",
                "receiverStatus": "ON",
                "receiverThreadState": "Waiting for source to send event",
                "source": "127.0.0.1:3310"
            },
            "clusterSetReplicationStatus": "OK",
            "globalStatus": "OK",
            "status": "OK",
            "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.",
            "topology": {
                "127.0.0.1:4410": {
                    "address": "127.0.0.1:4410",
                    "memberRole": "PRIMARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:4420": {
                    "address": "127.0.0.1:4420",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                },
                "127.0.0.1:4430": {
                    "address": "127.0.0.1:4430",
                    "memberRole": "SECONDARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.27"
                }
            },
            "transactionSet": "0f6ff279-2764-11ec-ba06-00059a3c7a00:1-5,953a51d5-2690-11ec-ba07-00059a3c7a00:1,c51c1b15-269e-11ec-b9ba-00059a3c7a00:1-131,c51c29ad-269e-11ec-b9ba-00059a3c7a00:1-8",
            "transactionSetConsistencyStatus": "OK",
            "transactionSetErrantGtidSet": "",
            "transactionSetMissingGtidSet": ""
        }
    },
    "domainName": "testclusterset",
    "globalPrimaryInstance": "127.0.0.1:3310",
    "metadataServer": "127.0.0.1:3310",
    "primaryCluster": "clusterone",
    "status": "HEALTHY",
    "statusText": "All Clusters available."
}

有关 clusterSet.status() 命令输出的更多信息，请参阅第 8.6 节“InnoDB ClusterSet 状态和拓扑”。

根据需要添加更多副本集群，方法是对不同的独立实例集重复上述步骤。InnoDB ClusterSet 部署中可以拥有的副本集群数量没有定义限制。每个案例的过程都是相同的，总结如下：
- 通过发出带有 clusterAdmin 选项的 dba.configureInstance() 命令，在每个独立服务器实例上创建 InnoDB 集群服务器配置帐户。
- 当您使用 InnoDB 集群服务器配置帐户连接到 InnoDB ClusterSet 的成员时，请使用 dba.getClusterSet() 或 cluster.getClusterSet() 获取 ClusterSet 对象。您可以从主集群或已创建的副本集群中的任何成员服务器获取该对象。
- 使用 ClusterSet 对象发出 clusterSet.createReplicaCluster() 命令，以创建副本集群，命名其中一个独立服务器实例。
- 使用 clusterSet.createReplicaCluster() 为副本集群返回的 Cluster 对象，发出一个 cluster.addInstance 命令，命名另一个独立服务器实例。
- 重复 cluster.addInstance 操作，将所有独立服务器实例添加到副本集群。
- 验证已完成的副本集群和 InnoDB ClusterSet 部署是否正常，例如，使用带有扩展输出的 clusterSet.status() 命令。
针对 InnoDB ClusterSet 引导 MySQL Router 实例以管理应用程序流量，并对其进行适当的配置。默认情况下，MySQL Router 会将所有读写请求定向到当前在 InnoDB ClusterSet 部署中为主集群的集群，但您可以将 MySQL Router 实例配置为仅将流量路由到特定集群。有关说明，请参阅第 8.5 节“将 MySQL Router 与 InnoDB ClusterSet 集成”。