本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立 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 Management Console 建立和設定複本代理程式。

**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>

若要使用跨區域資料複製功能，您必須檢閱並遵守下列先決條件：
+  **版本**：跨區域資料複寫功能僅適用於第 5.17.6 版和更新版本的 Amazon MQ for ActiveMQ 代理程式。
+  **區域**：下列區域支援跨區域複寫：美國東部 (俄亥俄)、美國東部 (維吉尼亞北部)、美國西部 (奧勒岡) 及美國西部 (加利佛尼亞北部)。
+  **執行個體類型**：跨區域資料複寫僅適用於大小 `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.  在**選取代理程式引擎**頁面上，選擇 **Apache ActiveMQ**。

1.  在**選取部署和儲存**頁面的**部署模式和儲存類型**區段中，執行下列動作：

   1. 針對**部署模式**，選擇**作用中/待命中介裝置提供高可用性**。**作用中/待命中介裝置提供高可用性**是由兩個不同可用區域中的兩個代理程式所組成，並設定於備援組合中。這些代理程式會與您的應用程式及 Amazon EFS 同步通訊。如需詳細資訊，請參閱[Amazon MQ for ActiveMQ 代理程式的部署選項](amazon-mq-broker-architecture.md)。

1.  選擇**下一步**。

1. 在 **Configure settings (進行設定)** 頁面的 **Details (詳細資訊)** 區段中，執行以下動作：

   1. 輸入**代理程式名稱**。
**重要**  
 請勿在代理程式名稱中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。其他 AWS 服務可存取中介裝置名稱，包括 CloudWatch Logs。代理程式名稱不適用於私有或敏感資料。

   1. 選擇**代理程式執行個體類型** (例如，**mq.m5.large**)。如需詳細資訊，請參閱[Amazon MQ for ActiveMQ 代理程式執行個體類型](broker-instance-types.md)。

1.  在 **ActiveMQ Web 主控台存取**區段中，提供**使用者名稱**和**密碼**。以下限制適用於代理程式使用者名稱和密碼：
   +  您的使用者名稱只能包含英數字元、破折號、句點、底線和波狀符號 (- . \_ \~)。
   +  密碼必須至少有 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 主控台使用者**區段中，提供複本代理程式主控台使用者的**使用者名稱**和**密碼**。以下限制適用於代理程式使用者名稱和密碼：
   +  您的使用者名稱只能包含英數字元、破折號、句點、底線和波狀符號 (- . \_ \~)。
   +  密碼必須至少有 12 個字元、包含至少 4 個唯一字元，而且不得包含逗號、冒號或等號 (,: =)。
**重要**  
請勿在代理程式使用者名稱中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。其他 AWS 服務可存取中介裝置使用者名稱，包括 CloudWatch Logs。代理程式使用者名稱不適用於私有或敏感資料。

1. 在**代理程式之間進行橋接存取的資料複寫使用者**區段中，提供將存取主要和複本代理程式之使用者的**使用者名稱**和**密碼**。以下限制適用於代理程式使用者名稱和密碼：
   +  您的使用者名稱只能包含英數字元、破折號、句點、底線和波狀符號 (- . \_ \~)。
   +  密碼必須至少有 12 個字元、包含至少 4 個唯一字元，而且不得包含逗號、冒號或等號 (,: =)。
**重要**  
請勿在代理程式使用者名稱中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。其他 AWS 服務可存取中介裝置使用者名稱，包括 CloudWatch Logs。代理程式使用者名稱不適用於私有或敏感資料。

   進行任何其他設定。然後選擇**下一步**。

1. 在**檢閱並建立**頁面上，檢閱複本代理程式詳細資訊。然後選擇**建立複本中介裝置**。

1.  接著重新啟動主要代理程式。這樣做也會重新啟動複本代理程式。如需有關重新啟動代理程式的指示，請參閱 [重新啟動 Amazon MQ 代理程式](amazon-mq-rebooting-broker.md)。

如需為 ActiveMQ 代理程式進行其他設定的詳細資訊，請參閱 [入門：建立並連線至 ActiveMQ 代理程式](getting-started-activemq.md)