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

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

升級 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 會將您的代理程式升級至下一個次要版本。手動和自動版本升級兩著會在排定的維護時段期間或在重新啟動代理程式之後發生。

下列主題說明如何手動升級代理程式引擎版本,以及啟用自動次要版本升級。

手動升級引擎版本

若要手動將代理程式的引擎版本升級為新的主要或次要版本 AWS Management Console,您可以使用 AWS CLI、或 Amazon MQ API。

使用升級代理程式的引擎版本 AWS Management Console
  1. 登入 Amazon MQ 主控台

  2. 在左側導覽窗格中,選擇 Brokers (代理程式),然後從清單中選擇您要升級的代理程式。

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

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

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

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

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

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

      重要

      您的代理程式會在重新啟動時離線。

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

使用升級代理程式的引擎版本 AWS CLI
  1. 使用更新代理程式CLI命令並指定下列參數,如範例所示。

    • --broker-id – Amazon MQ 針對代理程式產生的唯一 ID。您可以從經紀人解析 ID ARN。例如,給定以下內容 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. (選擇性) 如果您想要立即升級引擎版本,請使用重新開機代理程式CLI命令來重新啟動代理程式。

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

    如果您不想立即重新啟動代理程式並套用變更,Amazon MQ 會在下一個排定的維護時段期間升級代理程式。

    重要

    您的代理程式會在重新啟動時離線。

使用 Amazon MQ 升級代理程式的引擎版本 API
  1. 使用UpdateBrokerAPI操作。指定 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. (選擇性) 如果您要立即升級引擎版本,請使用此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 會在下一個排定的維護時段期間升級代理程式。

    重要

    您的代理程式會在重新啟動時離線。

自動升級次要引擎版本

您可以控制是否在第一次建立代理程式時,或藉由修改代理程式偏好設定,為代理程式啟用自動次要版本升級。若要啟用現有代理程式的 auto 次要版本升級 AWS Management Console,您可以使用 AWS CLI、或 Amazon MQ API。

若要啟用自動次要版本升級,請使用 AWS Management Console
  1. 登入 Amazon MQ 主控台

  2. 在左側導覽窗格中,選擇 Brokers (代理程式),然後從清單中選擇您要升級的代理程式。

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

  4. Maintenance (維護) 之下,選擇 Enable automatic minor version upgrades (啟用自動次要版本升級)

    注意

    如果已選取此選項,您不需要進行任何變更。

  5. 選擇頁面底部的 Save (儲存)。

若要透過啟動自動次要版本升級 AWS CLI,請使用 updatete-Broker 指CLI令並指定下列參數。

  • --broker-id – Amazon MQ 針對代理程式產生的唯一 ID。您可以從經紀人解析 ID ARN。例如,給定以下內容 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 端點的詳細資訊,請參閱 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

在請求承載中使用 autoMinorVersionUpgrade 屬性,以啟用自動次要版本升級。

{ "autoMinorVersionUpgrade": "true" }

如果您想要為代理程式停用自動次要版本升級,請在請求承載中設定 "autoMinorVersionUpgrade": "false"