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

# 入门：创建并连接 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 (部署模式)**（例如 **Active/standby broker (主动/备用代理)**）。有关更多信息，请参阅 [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：亚马逊 MQ active/standby 代理以实现高可用性](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. 输入 **Broker name (代理名称)**。
**重要**  
 请勿在代理名称中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理名称。代理名称不适合用于私有或敏感数据。
**注意**  
 在**其他设置**部分，您还可以配置以下内容：  
 [配置](amazon-mq-broker-configuration-parameters.md) 
 [CloudWatch Logs](security-logging-monitoring.md) 
 私有访问 
 [代理维护窗口](maintaining-brokers.md) 

   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）可以访问代理用户名。代理用户名不适合用于私有或敏感数据。

1. 选择**部署**。

   当 Amazon MQ 创建您的代理时，会显示 **Creation in progress (正在创建)** 状态。

   创建代理大约需要 15 分钟。

   成功创建您的代理后，Amazon MQ 会显示 **Running (正在运行)** 状态。

1. 选择 ***MyBroker***。

   在 ***MyBroker*** 页面的**连接**部分，记下代理的 **[ActiveMQ Web 控制台](http://activemq.apache.org/web-console.html)** 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
   ```