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

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

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

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

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

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

1. 在 **Select broker engine (選取代理程式引擎)** 頁面上，選擇 **Apache ActiveMQ**。

1. 在 **Select deployment and storage (選取部署和儲存)** 頁面的 **Deployment mode and storage type (部署模式和儲存類型)** 區段中，執行下列動作：

   1. 選擇 **Deployment mode (部署模式)** (例如，**作用中/待命代理程式**)。如需詳細資訊，請參閱 [Amazon MQ for ActiveMQ 代理程式的部署選項](amazon-mq-broker-architecture.md)。
      + **單一執行個體代理程式**是由一個可用區域中的一個代理程式組成。代理程式會與您的應用程式以及 Amazon EBS 或 Amazon EFS 儲存磁碟區進行通訊。如需詳細資訊，請參閱[選項 1：Amazon MQ 單一執行個體代理程式](amazon-mq-broker-architecture.md#single-broker-deployment)。
      + **高可用性的作用中/待命代理程式**是由兩個不同可用區域中的兩個代理程式所組成，並設定於*備援組合*中。這些代理程式會與您的應用程式及 Amazon EFS 同步通訊。如需詳細資訊，請參閱[選項 2：Amazon MQ 作用中/待命代理程式可提供高可用性](amazon-mq-broker-architecture.md#active-standby-broker-deployment)。

   1. 選擇 **Storage type (儲存體類型)** (例如，**EBS**)。如需詳細資訊，請參閱[Amazon MQ for ActiveMQ 儲存類型](broker-storage.md)。
**注意**  
Amazon EBS 會複寫單一可用區域內的資料，且不支援 [ActiveMQ 作用中/待命](amazon-mq-broker-architecture.md#active-standby-broker-deployment)部署模式。

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

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

   1. 輸入**代理程式名稱**。
**重要**  
 請勿在代理程式名稱中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。其他 AWS 服務可存取中介裝置名稱，包括 CloudWatch Logs。代理程式名稱不適用於私有或敏感資料。
**注意**  
 **在其他設定**區段中，您也可以設定下列項目：  
 [組態](amazon-mq-broker-configuration-parameters.md) 
 [CloudWatch 日誌](security-logging-monitoring.md) 
 私有存取 
 [中介裝置維護時段](maintaining-brokers.md) 

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

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

1. 選擇**部署**。

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

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

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

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

   在 ***MyBroker*** 頁面的 **Connect** (連線) 區段中，請記下代理程式的 **[ActiveMQ web console](http://activemq.apache.org/web-console.html)** (ActiveMQ Web 主控台) URL，例如：

   ```
   https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162
   ```

   此外，請記下代理程式的[線路通訊協定**端點**](http://activemq.apache.org/configuring-transports.html)。以下是 OpenWire 端點的範例：

   ```
   ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617
   ```