View a markdown version of this page

升級 Amazon MQ 代理程式引擎版本 - Amazon MQ
手動升級引擎版本

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

升級 Amazon MQ 代理程式引擎版本

Amazon MQ 會定期為所有支援的代理程式引擎類型提供新的代理程式引擎版本。新的引擎版本包括安全性修補程式、錯誤修正和其他代理程式引擎改進。

Amazon MQ 根據語意版本控制規格將版本編號組織為 X.Y.Z。在 Amazon MQ 實作中， X表示主要版本， Y表示次要版本， Z表示修補程式版本編號。Amazon MQ 支援兩種類型的升級：

  • 主要版本升級 – 發生於主要引擎版本號碼變更時。例如，從 RabbitMQ 3.13 版升級至 4.2 版視為主要版本升級。

  • 次要版本升級 – 僅發生於次要引擎版本號碼變更時。例如，從 3.11 版升級至 3.12 版會被視為次要版本升級。

您可以隨時手動將代理程式升級至下一個支援的主要或次要版本。在排程維護時段期間，Amazon MQ 會管理所有代理程式升級至最新支援的修補程式版本。手動和自動版本升級都會在排定的維護時段期間或重新啟動代理程式之後進行。當目前的次要版本終止支援時，Amazon MQ 會將您的代理程式升級至下一個次要版本。

手動升級引擎版本

您可以使用 AWS CLI、 AWS 管理主控台或 Amazon MQ API 來升級代理程式的引擎版本。

使用 升級代理程式的引擎版本 AWS 管理主控台

  1. 在代理程式詳細資訊頁面上，選擇 Edit (編輯)。

  2. 在 Specifications (規格) 之下，針對 Broker engine version (代理程式引擎版本)，從下拉式清單中選擇新的版本號碼。

  3. 捲動到頁面底部，然後選擇 Schedule modification (排程修改)。

  4. 在 Schedule broker modifications (排定代理程式修改) 頁面上，針對 When to apply modifications (套用修改的時機)，選擇下列其中一項。

    • 如果您希望 Amazon MQ 在下一個排定的維護時段完成版本升級，請選擇 After the next reboot (在下次重新啟動後)。

    • 如果您想要重新啟動代理程式並立即升級引擎版本，請選擇 Immediately (立即)。

      重要

      單一執行個體代理程式在重新啟動時處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。

  5. 選擇 Apply (套用) 以完成變更套用。

使用 升級代理程式的引擎版本 AWS 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 端點的詳細資訊，請參閱 AWS 一般參考 中的 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 會在下一個排定的維護時段期間升級代理程式。

    重要

    單一執行個體代理程式在重新啟動時處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。