升级 Amazon MQ 代理实例类型 - Amazon MQ
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

升级 Amazon MQ 代理实例类型

重要

mq.m7g.x 实例仅适用于 Amazon MQ for RabbitMQ 代理。Amazon MQ for ActiveMQ 代理仅使用 mq.m5.x 实例。

代理实例类 (m7g) 和大小 (large) 的组合描述称为代理实例类型（例如，mq.m7g.large）。选择实例类型时，必须考虑会影响代理性能的因素：

  • 客户端和队列的数量

  • 发送的消息量

  • 保存在内存中的消息

  • 冗余消息

建议仅在测试应用程序性能时使用较小的代理实例类型 (mq.m7g.medium)。对于生产级别的客户端和队列、高吞吐量、内存中的消息和冗余消息，我们建议使用较大的代理实例类型（mq.m7g.large 及以上）。

如果您遇到性能问题，或者从测试环境迁移到生产环境，我们建议升级到更大的实例类型（即从 micro 到 large）。要升级您的实例类型，您可以使用 Amazon Web Services 管理控制台、Amazon CLI 或 Amazon MQ API。

要使用 Amazon Web Services 管理控制台 升级到更大的实例类型，请执行以下操作：

  1. 登录 Amazon MQ 控制台。

  2. 在左侧导航窗格中，选择 Brokers (代理)，然后从列表中选择您要升级的代理。

  3. 在代理详细信息页上，选择 Edit (编辑)。

  4. 在规格下，对于代理实例类型，从下拉列表中选择新的实例类型。

  5. 在页面底部，选择计划修改。

  6. 在 Schedule broker modifications (计划代理修改) 页面上，对于 When to apply modifications (何时应用修改) 下，选择以下选项之一。

    • 选择下次重启后，如果您希望 Amazon MQ 在下一个计划维护窗口中完成升级。

    • 选择立即，如果您希望立即重启代理并升级实例类型。

      重要

      单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。

  7. 选择 Apply (应用) 以完成应用更改。

要使用 Amazon CLI 升级代理的实例类型

  1. 使用 modify-broker CLI 命令并指定以下参数，如示例所示。

    • --broker-id – Amazon MQ 为代理生成的唯一 ID。

    • --host-instance-type – 代理引擎要升级到的版本号。

    aws mq modify-broker --broker-id broker-id --host-instance-type instance-type

  2. （可选）如果您想立即升级实例类型，请使用 reboot-broker CLI 命令重启代理。

    aws mq reboot-broker --broker-id broker-id

    如果您不想重新启动代理和立即应用更改，Amazon MQ 将在下一个计划维护时段内升级代理。

    重要

    单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。

要使用 Amazon MQ API 升级代理的实例类型

  1. 使用 UpdateBroker API 操作。指定 broker-id 作为路径参数。以下示例假定代理在 us-west-2 区域中。有关可用 Amazon MQ 端点的更多信息，请参阅 Amazon Web Services 一般参考 中的 Amazon MQ 端点和配额。

    PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    在请求有效载荷中使用 host-instance-type 指定代理要升级到的实例类型。

    {
    "host-instance-type": "host-instance-type"
}

  2. （可选）如果您想立即升级引擎版本，请使用 RebootBroker API 操作重新启动您的代理。broker-id 已指定为路径参数。

    POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    如果您不想重新启动代理和立即应用更改，Amazon MQ 将在下一个计划维护时段内升级代理。

    重要

    单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。