升级 Amazon MQ 代理引擎版本 - Amazon MQ
手动升级引擎版本自动升级次要引擎版本
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

升级 Amazon MQ 代理引擎版本

Amazon MQ 会定期为所有支持的代理引擎类型提供新的代理引擎版本。新的引擎版本包括安全补丁、错误修复和其他代理引擎改进。

Amazon MQ 根据语义版本控制规范将版本号整理为 X.Y.Z。在 Amazon MQ 实现中，X 表示主要版本，Y 表示次要版本，Z 表示补丁版本号。升级有两种类型：

  • 主要版本升级 – 当主要引擎版本号更改时发生。例如，从 1.0 版升级到 2.0 版被视为主要版本升级。

  • 次要版本升级 – 仅在次要引擎版本号更改时发生。例如，从 1.5 版升级到 1.6 版被视为次要版本升级。

您可以随时手动将代理升级到下一个受支持的主要版本或次要版本。启用自动次要版本升级后，Amazon MQ 会将代理升级到支持的最新补丁版本。对于所有使用引擎版本 3.13 及更高版本的代理，Amazon MQ 会在维护时段内管理升级到所支持的最新补丁版本。当前次要版本的支持终止时，Amazon MQ 会将代理升级到下一个次要版本。手动和自动版本升级会在计划的维护时段期间或在您重新启动代理之后发生。

以下主题介绍如何手动升级代理引擎版本，以及如何激活自动次要版本升级。

手动升级引擎版本

要手动将代理的引擎版本升级到新的主要版本或次要版本，您可以使用 Amazon Web Services Management Console Amazon CLI、或 Amazon MQ API。

要升级代理的引擎版本，请使用 Amazon Web Services Management Console

  1. 登录 Amazon MQ 控制台。

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

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

  4. 在 Specifications (规格) 下，对于 Broker engine version (代理引擎版本)，从下拉列表中选择新版本号。

  5. 滚动到页面底部并选择 Schedule modifications (计划修改)。

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

    • 如果您希望 Amazon MQ 在下一个计划维护时段完成版本升级，请选择 After the next reboot (下次重新启动后)。

    • 如果您想立即重新启动代理并升级引擎版本，请选择 Immediately (立即)。

      重要

      单实例代理在重启时处于离线状态。对于集群代理，当代理重启时，一次只有一个节点处于停机状态。

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

要升级代理的引擎版本，请使用 Amazon CLI

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

    • --broker-id – Amazon MQ 为代理生成的唯一 ID。您可以通过代理 ARN 解析 ID。例如，给定以下 ARN arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9，代理 ID 将为 b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9。

    • --engine-version – 代理引擎要升级到的版本号。

    aws mq update-broker --broker-id broker-id --engine-version version-number

  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

    在请求负载中使用 engineVersion 指定要升级到的代理的版本号。

    {
    "engineVersion": "engine-version-number"
}

  2. （可选）如果您想立即升级引擎版本，请使用 RebootBrokerAPI 操作重启您的代理。 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 将在下一个计划维护时段内升级代理。

    重要

    单实例代理在重启时处于离线状态。对于集群代理，当代理重启时，一次只有一个节点处于停机状态。

自动升级次要引擎版本

您可以控制是否在首次创建代理时激活自动次要版本升级，还是通过修改代理首选项来控制。要激活现有代理的自动次要版本升级，您可以使用 Amazon Web Services Management Console Amazon CLI、或 Amazon MQ API。

要激活自动次要版本升级，请使用 Amazon Web Services Management Console

  1. 登录 Amazon MQ 控制台。

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

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

  4. 在 Maintenance (维护) 中，选择 Enable automatic minor version upgrades (启用自动次要版本升级)。

    注意

    如果选择了该选项，则无需进行任何更改。

  5. 在页面底部选择 Save (保存)。

要通过激活自动次要版本升级 Amazon CLI，请使用 update-broker CLI 命令并指定以下参数。

  • --broker-id – Amazon MQ 为代理生成的唯一 ID。您可以通过代理 ARN 解析 ID。例如，给定以下 ARN arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9，代理 ID 将为 b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9。

  • --auto-minor-version-upgrade – 激活自动次要版本升级选项。

aws mq update-broker --broker-id broker-id --auto-minor-version-upgrade

如果您想为您的代理停用自动次要版本升级，请使用 --no-auto-minor-version-upgrade 参数。

要通过 Amazon MQ API 激活自动次要版本升级，请使用 AP UpdateBrokerI 操作。指定 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

使用请求负载中的 autoMinorVersionUpgrade 属性来激活自动次要版本升级。

{
    "autoMinorVersionUpgrade": "true"
}

如果您想为您的代理停用自动次要版本升级，请在请求有效负载中设置"autoMinorVersionUpgrade": "false"。