升级 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 会将您的代理升级到可用的新次要版本。仅当代理运行的次要引擎版本低于建议的新的次要版本升级时,才会发生自动次要版本升级。对于主要升级,您必须手动升级引擎版本。

手动和自动版本升级会在计划的维护时段期间或在您重新启动代理之后发生。

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

手动升级引擎版本

要手动将代理的引擎版本升级到新的主要版本或次要版本升级,您可以使用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一般参考》中的 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. (可选)如果您想立即升级引擎版本,请使用 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 将在下一个计划维护时段内升级代理。

    重要

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

自动升级次要引擎版本

您可以控制是否在首次创建代理时激活自动次要版本升级,还是通过修改代理首选项来控制。要为现有的代理激活自动次要版本升级,您可以使用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 激活自动次要版本升级,请使用 UpdateBroker API 操作。指定 broker-id 作为路径参数。以下示例假定代理在 us-west-2 区域中。有关可用的 Amazon MQ 终端节点的更多信息,请参阅《Amazon一般参考》中的 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"