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

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

升级 Amazon MQ 代理引擎版本

Amazon MQ 为所有受支持的经纪商引擎类型提供了新的经纪商引擎版本。新的引擎版本可能包括安全修补程序、错误修复和其他经纪商引擎改进。当 Amazon MQ 支持新的引擎版本时,您可以控制如何以及何时升级您的代理。

经纪人引擎版本组织为X.Y.Z。在每种引擎类型的 Amazon MQ 实现中,X.Y被认为是主要版本,Z被认为是次要版本。共有两种类型的升级:

  • 主要版本升级— 当主要引擎版本号更改时发生。例如,从版本 1 升级。0到版本 1。1被认为是主要版本升级。

  • 次要版本升级— 仅次要引擎版本号更改时发生。例如,从版本 1.1 升级。0到版本 1.1。1被认为是次要版本升级。

有关针对每个特定的代理引擎类型的主要版本管理和次要版本管理的更多信息,请参阅以下主题。

当您激活自动次要版本升级选项时,Amazon MQ 将您的经纪商升级到新的次要版本。仅当代理正运行的次要引擎版本低于推荐的新次要版本升级。对于主要升级,您必须手动升级引擎版本。

手动和自动版本升级都会在计划维护时段内或在您重启代理

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

手动升级引擎版本

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

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

  1. 登录到Amazon MQ 控制台

  2. 在左侧导航窗格中,依次选择和代理,然后从列表中选择要升级的代理。

  3. 在代理详细信息页面上,选择编辑

  4. UNDER规范, 用于代理引擎版本版本从下拉列表中选择新版本号。

  5. 滚动到页面底部,然后选择计划修改

  6. 在存储库的计划代理修改页面, 用于何时应用修改下,选择以下选项之一:

    • 选择下次重新启动后,如果您希望 Amazon MQ 在下一个计划的维护时段完成版本升级。

    • 选择Immediate,如果您想立即重新启动 Broker 并升级引擎版本。

      重要

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

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

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

  1. 使用更新代理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. (可选)使用重新启动代理CLI 命令重新启动您的代理,如果您想立即升级引擎版本。

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

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

    重要

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

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

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

    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指定要升级到的 Broker 的版本号。

    { "engineVersion": "engine-version-number" }
  2. (可选)使用重新启动代理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 将在下一个计划维护时段内升级代理。

    重要

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

自动升级次要引擎版本

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

使用控制台激活自动次要版本升级Amazon Web Services Management Console

  1. 登录到Amazon MQ 控制台

  2. 在左侧导航窗格中,依次选择和代理,然后从列表中选择要升级的代理。

  3. 在代理详细信息页面上,选择编辑

  4. UNDER维护中,选择启用自动次要版本升级

    注意

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

  5. 在页面底部选择 Save

要激活自动次要版本升级,使用Amazon CLI,使用更新代理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 激活自动次要版本升级,请使用更新代理API 操作。指定broker-id作为路径参数。下面的示例假定在us-west-2区域。有关 Amazon MQ 终端节点的更多信息,请参阅Amazon MQ 终端节点和配额。中的Amazon一般参考

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"在请求负载中。