本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建 Amazon MQ 跨区域数据复制代理
<a name="create-replica-broker"></a>

 使用跨区域数据复制（CRDR)，您可以根据需要，在两个 AWS 区域中的 Amazon MQ for ActiveMQ 消息代理之间切换。您可以将现有代理指定为主代理并为该代理创建副本，也可以同时创建新的主代理和副本代理。然后，您可以使用 Amazon MQ `Promote` API 操作将副本代理提升为主代理角色。有关主代理和副本代理的更多信息，请参阅[用于跨区域数据复制的主代理和副本代理](crdr-for-active-mq.md#crdr-primary-replica-brokers)。

 以下说明描述了如何使用 Amazon MQ 管理控制台创建和配置副本代理。

**Topics**
+ [先决条件](#create-crdr-broker-prerequisites)
+ [步骤 1（可选）：创建新的主代理](#create-new-primary-broker)
+ [Create a replica of an existing broker](#create-new-replica-broker)

## 先决条件
<a name="create-crdr-broker-prerequisites"></a>

要使用跨区域数据复制功能，您必须查看并遵守以下先决条件：
+  **版本**：跨区域数据复制功能仅适用于Amazon MQ for ActiveMQ 代理 5.17.6 及更高版本。
+  **区域**：以下区域支持跨区域数据复制：美国东部（俄亥俄州）、美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）、美国西部（北加利福尼亚）。
+  **实例类型**：跨区域数据复制仅适用于代理实例大小 `mq.m5.large` 及更大规模。
+  **部署类型**：跨区域数据复制仅适用于部署了多可用区的活动/备用代理。
+  **代理状态**：您只能为代理状态为 `Running` 的主代理创建副本代理。

## 步骤 1（可选）：创建新的主代理
<a name="create-new-primary-broker"></a>

### 创建新的主代理
<a name="create-new-primary-broker-procedure"></a>

1. 登录 [Amazon MQ 控制台](https://console.aws.amazon.com/amazon-mq/)。

1. 在 Amazon MQ 控制台的“代理”页面上，选择**创建代理**。

1.  在 **Select broker engine (选择代理引擎)** 页面上，选择 **Apache ActiveMQ**。

1.  在 **Select deployment and storage (选择部署和存储)** 页面的 **Deployment mode and storage type (部署模式和存储类型)** 部分，执行以下操作：

   1. 对于**部署模式**，选择**主动/备用代理**。**主动/备用代理**由两个不同可用区中配置为冗余对的两个代理组成。这些代理与您的应用程序以及 Amazon EFS 进行同步通信。有关更多信息，请参阅 [Amazon MQ for ActiveMQ 代理的部署选项](amazon-mq-broker-architecture.md)。

1.  选择**下一步**。

1. 在 **Configure settings (配置设置)** 页面的 **Details (详细信息)** 部分，执行以下操作：

   1. 输入 **Broker name (代理名称)**。
**重要**  
 请勿在代理名称中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理名称。代理名称不适合用于私有或敏感数据。

   1. 选择 **Broker instance type (代理实例类型)**（例如 **mq.m5.large**）。有关更多信息，请参阅 [Amazon MQ for ActiveMQ 代理实例类型](broker-instance-types.md)。

1.  在 **ActiveMQ Web Console access (ActiveMQ Web 控制台访问)** 部分，提供 **Username (用户名)** 和 **Password (密码)**。以下限制适用于代理用户名和密码：
   +  用户名只能包含字母数字字符、短划线、句点、下划线和波浪线（- . \$1 \$1）。
   +  密码必须至少为 12 个字符，包含至少 4 个唯一字符，并且不得包含逗号、冒号或等号（,:=）。
**重要**  
请勿在代理用户名中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理用户名。代理用户名不适合用于私有或敏感数据。

页面顶部的绿色闪存栏确认 Amazon MQ 正在恢复区域中创建副本代理。您还可以查看代理的 CRDR 角色和 RPO 状态。要关闭“CRDR 角色”和“RPO 状态”列，请选择**代理**表右上角的齿轮图标。然后，在**首选项**页面上，关闭 CRDR 角色或 RPO 状态。

## 步骤 2：创建现有代理的副本
<a name="create-new-replica-broker"></a>

1. 在 Amazon MQ 控制台的“代理”页面上，选择**创建副本代理**。

1. 在**选择主代理**页面上，选择要用作 CRDR 主代理的现有代理。然后选择**下一步**。

1. 在**配置副本代理**页面上，使用下拉菜单选择副本区域。

1. 在**副本代理的 ActiveMQ 控制台用户**部分中，提供副本代理控制台用户的**用户名**和**密码**。以下限制适用于代理用户名和密码：
   +  用户名只能包含字母数字字符、短划线、句点、下划线和波浪线（- . \$1 \$1）。
   +  密码必须至少为 12 个字符，包含至少 4 个唯一字符，并且不得包含逗号、冒号或等号（,:=）。
**重要**  
请勿在代理用户名中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理用户名。代理用户名不适合用于私有或敏感数据。

1. 在**用于在代理之间桥接访问的数据复制用户**部分中，提供将访问主代理和副本代理的用户的**用户名**和**密码**。以下限制适用于代理用户名和密码：
   +  用户名只能包含字母数字字符、短划线、句点、下划线和波浪线（- . \$1 \$1）。
   +  密码必须至少为 12 个字符，包含至少 4 个唯一字符，并且不得包含逗号、冒号或等号（,:=）。
**重要**  
请勿在代理用户名中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理用户名。代理用户名不适合用于私有或敏感数据。

   配置任何其他设置。然后选择**下一步**。

1. 在**查看并创建**页面上，查看副本代理的详细信息。然后，选择**创建副本代理**。

1.  接下来，重启主代理。这也将重启副本代理。有关重启代理的说明，请参阅[重启 Amazon MQ 代理](amazon-mq-rebooting-broker.md)。

有关为 ActiveMQ 代理配置其他设置的更多信息，请参阅[入门：创建并连接 ActiveMQ 代理](getting-started-activemq.md)