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

# 入门：创建并连接 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 broker 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 集群部署**是由 Network Load Balancer 后面的三个 RabbitMQ 代理节点组成的逻辑分组，每个节点在多个可用区（AZ）之间共享用户、队列和分布式状态。有关更多信息，请参阅 [选项 2：Amazon MQ for RabbitMQ 集群部署](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster)。

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

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

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

1. 在 **Configure settings (配置设置)** 页面的 **RabbitMQ access (RabbitMQ 访问)** 部分，提供 **Username (用户名)** 和 **Password (密码)**。以下限制适用于代理程序登录凭证：
   +  用户名只能包含字母数字字符、短划线、句点和下划线（- . \_）。此值不得包含任何波浪线（\~）字符。Amazon MQ 禁止使用 `guest` 作为用户名。
   +  密码必须至少为 12 个字符，包含至少 4 个唯一字符，并且不得包含逗号、冒号或等号（,:=）。
**重要**  
请勿在代理用户名中添加个人身份信息（PII）或其他机密或敏感信息。其他AWS服务（包括 CloudWatch Logs）可以访问代理用户名。代理用户名不适合用于私有或敏感数据。
**注意**  
 在**其他设置**部分，您还可以配置以下内容：  
 [配置](rabbitmq-broker-configuration-parameters.md) 
 [CloudWatch Logs](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}}** 页面的**连接**部分，记下代理的 **[RabbitMQ Web 控制台](https://www.rabbitmq.com/management.html)** URL，例如：

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

   另外，请记下您代理的 [secure-AMQP **终端节点**](https://www.rabbitmq.com/connections.html)。以下是一个 `amqps` 终端节点显示侦听器端口 `5671` 的示例。

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