入门:创建并连接 ActiveMQ 代理
代理 是运行在 Amazon MQ 上的消息代理环境。它是 Amazon MQ 的基本构建块。代理实例类 (m5) 和大小 (large, medium) 的组合描述称为代理实例类型(例如,mq.m5.large)。有关更多信息,请参阅 什么是 Amazon MQ for ActiveMQ 代理?。
创建 ActiveMQ 代理
第一个也是最常见的 Amazon MQ 任务是创建代理。以下示例演示如何使用Amazon Web Services 管理控制台创建基本代理。
登录 Amazon MQ 控制台
。 -
在 Select broker engine (选择代理引擎) 页面上,选择 Apache ActiveMQ。
-
在 Select deployment and storage (选择部署和存储) 页面的 Deployment mode and storage type (部署模式和存储类型) 部分,执行以下操作:
-
选择 Deployment mode (部署模式)(例如 Active/standby broker (主动/备用代理))。有关更多信息,请参阅 Amazon MQ for ActiveMQ 代理的部署选项。
-
单实例代理由一个可用区中的一个代理组成。代理与您的应用程序以及 Amazon EBS 或 Amazon EFS 存储卷进行通信。有关更多信息,请参阅 选项 1:Amazon MQ 单实例代理。
-
高可用性的主动/备用代理由两个不同可用区中的两个代理组成,以冗余对配置。这些代理与您的应用程序以及 Amazon EFS 进行同步通信。有关更多信息,请参阅 选项 2:用于实现高可用性的 Amazon MQ 主动/备用代理。
-
-
选择 Storage type (存储类型)(例如 EBS)。有关更多信息,请参阅 Storage。
注意
Amazon EBS 在单个可用区内复制数据,但不支持 ActiveMQ 主动/备用部署模式。
选择下一步。
-
-
在 Configure settings (配置设置) 页面的 Details (详细信息) 部分,执行以下操作:
-
输入 Broker name (代理名称)。
重要
请勿在代理名称中添加个人身份信息(PII)或其他机密或敏感信息。其他Amazon服务(包括 CloudWatch Logs)可以访问代理名称。代理名称不适合用于私有或敏感数据。
注意
在其他设置部分,您还可以配置以下内容:
-
私有访问
选择 Broker instance type (代理实例类型)(例如 mq.m5.large)。有关更多信息,请参阅 Broker instance types。
-
-
在 ActiveMQ Web Console access (ActiveMQ Web 控制台访问) 部分,提供 Username (用户名) 和 Password (密码)。以下限制适用于代理用户名和密码:
-
用户名只能包含字母数字字符、短划线、句点、下划线和波浪线(- . _ ~)。
-
密码必须至少为 12 个字符,包含至少 4 个唯一字符,并且不得包含逗号、冒号或等号(,:=)。
重要
请勿在代理用户名中添加个人身份信息(PII)或其他机密或敏感信息。其他Amazon服务(包括 CloudWatch Logs)可以访问代理用户名。代理用户名不适合用于私有或敏感数据。
-
-
选择部署。
当 Amazon MQ 创建您的代理时,会显示 Creation in progress (正在创建) 状态。
创建代理大约需要 15 分钟。
成功创建您的代理后,Amazon MQ 会显示 Running (正在运行) 状态。
-
选择
MyBroker。在
MyBroker页面的连接部分,记下代理的 ActiveMQ Web 控制台URL,例如: https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162另外,请记下您代理的线级协议终端节点
。以下是 OpenWire 终端节点的示例: ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617