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

# 入門：建立並連線至 RabbitMQ 代理程式
<a name="getting-started-rabbitmq"></a>

*代理程式*是在 Amazon MQ 上執行的訊息代理程式環境。這是 Amazon MQ 的基本建置區塊。中介裝置執行個體*類別* (`m5`) 和*大小* (`large`、`medium`) 的合併描述稱為*中介裝置執行個體類型* （例如 `mq.m5.large`)。如需詳細資訊，請參閱[什麼是 Amazon MQ for RabbitMQ 代理程式？](working-with-rabbitmq.md#rabbitmq-basic-elements-broker)

## 建立 RabbitMQ 代理程式
<a name="create-rabbitmq-broker"></a>

第一個最常見的 Amazon MQ 任務是建立代理程式。下列範例示範如何使用 AWS 管理主控台 來建立基本代理程式。

建立 Amazon MQ for RabbitMQ 代理程式時，請遵循 [ RabbitMQ 的代理程式設定最佳實務](best-practices-broker-setup.md)，以最大化代理程式效能並最佳化訊息輸送量效率。

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

1. 在 **Select engine (選取引擎)** 頁面中，選擇 **RabbitMQ**，然後選擇 **Next (下一步)**。

1. 在 **Select deployment mode (選取部署模式)** 頁面上，選擇 **Deployment mode (部署模式)**，例如，**Cluster deployment (叢集部署)**，然後選擇 **Next (下一步驟)**。
   + **單一執行個體代理程式**是由 Network Load Balancer (NLB) 後面的一個可用區域中的一個代理程式組成。代理程式會與您的應用程式以及 Amazon EBS 儲存磁碟區進行通訊。如需詳細資訊，請參閱[選項 1：Amazon MQ for RabbitMQ 單一執行個體代理程式](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-single-instance)。
   + **RabbitMQ cluster deployment for high availability (提供高可用性的 RabbitMQ 叢集部署)** 是 Network Load Balancer 後面的三個 RabbitMQ 代理程式節點的邏輯分組，每個節點共用使用者、佇列，以及跨多個可用區域 (AZ) 的分散式狀態。如需詳細資訊，請參閱[選項 2：Amazon MQ for RabbitMQ 叢集部署](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster)。

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

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

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

1. 在 **Configure settings (進行設定)** 頁面的 **RabbitMQ access (RabbitmQ 存取)** 區段上，提供 **Username (使用者名稱)** 和 **Password (密碼)**。以下限制適用於代理程式登入認證：
   +  使用者名稱只能包含英數字元、破折號、句點和底線 (- . \$1)。此值不得包含任何波狀符號 (\$1) 字元。Amazon MQ 禁止使用 `guest` 作為使用者名稱。
   +  密碼必須至少有 12 個字元、包含至少 4 個唯一字元，而且不得包含逗號、冒號或等號 (,: =)。
**重要**  
請勿在代理程式使用者名稱中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。其他 AWS 服務可存取中介裝置使用者名稱，包括 CloudWatch Logs。代理程式使用者名稱不適用於私有或敏感資料。
**注意**  
 **在其他設定**區段中，您也可以設定下列項目：  
 [組態](rabbitmq-broker-configuration-parameters.md) 
 [CloudWatch 日誌](security-logging-monitoring.md) 
 私有存取 
 [中介裝置維護時段](maintaining-brokers.md) 

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

1. 在 **Review and create (檢閱和建立)** 頁面上，您可以檢閱您的選取項目，然後視需要編輯它們。

1. 選擇 **Create broker (建立代理程式)**。

   當 Amazon MQ 建立您的代理程式時，其會顯示 **Creation in progress (正在建立)** 狀態。

   建立代理程式大約需要 15 分鐘。

   成功建立代理程式後，Amazon MQ 會顯示 **Running (執行中)** 狀態。

1. 選擇 ***MyBroker***。

   在 ***MyBroker*** 頁面的 **Connect** (連線) 區段中，請記下代理程式的 **[RabbitMQ web console](https://www.rabbitmq.com/management.html)** (RabbitMQ Web 主控台) URL，例如：

   ```
   https://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws
   ```

   此外，請記下代理程式的[安全 AMQP **端點**](https://www.rabbitmq.com/connections.html)。以下是的 `amqps` 端點公開接聽程式連接埠 `5671` 的範例。

   ```
   amqps://b-c8349341-ec91-4a78-ad9c-a57f23f235bb.mq.us-west-2.on.aws:5671
   ```