升级 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。例如，根据以下情况 ARNarn: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-b roker CLI 命令重启您的代理。

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

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

    重要

    您的代理将在重启时脱机。

使用 Amazon MQ 升级代理的引擎版本 API

  1. 使用该UpdateBrokerAPI操作。指定 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。例如，根据以下情况 ARNarn: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，请使用操作。UpdateBrokerAPI指定 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"。