Amazon MQ ブローカーエンジンバージョンのアップグレード - Amazon MQ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon MQ ブローカーエンジンバージョンのアップグレード

Amazon MQ は、サポートされているすべてのブローカーエンジンタイプに対して、新しいブローカーエンジンバージョンを定期的に提供します。新しいエンジンバージョンには、セキュリティパッチ、バグ修正、その他のブローカーエンジンの改善が含まれています。

Amazon MQ は、X.Y.Z 形式のセマンティックバージョニングに従ってバージョン番号を分類します。Amazon MQ の実装では、X はメジャーバージョンを示し、Y はマイナーバージョンを表し、Z はパッチバージョン番号を示します。Amazon MQ は 2 種類のアップグレードをサポートしています。

  • メジャーバージョンアップグレード – メジャーエンジンバージョン番号が変更されたときに行われます。例えば、RabbitMQ バージョン 3.13 からバージョン 4.2 へのアップグレードは、メジャーバージョンのアップグレードと見なされます。

  • マイナーバージョンアップグレード – マイナーエンジンバージョン番号のみが変更されたときに行われます。たとえば、バージョン 3.11 からバージョン 3.12 へのアップグレードは、マイナーバージョンアップグレードと見なされます。

ブローカーはいつでも、サポートされている次のメジャーバージョンまたはマイナーバージョンに手動でアップグレードできます。Amazon MQ は、スケジュールされたメンテナンスウィンドウ中に、すべてのブローカーでサポートされている最新のパッチバージョンへのアップグレードを管理します。手動バージョンアップグレードと自動バージョンアップグレードは、スケジュールされたメンテナンスウィンドウ中、またはブローカーを再起動した後に行われます。Amazon MQ は、現在のマイナーバージョンがサポート終了に達すると、ブローカーを次のマイナーバージョンにアップグレードします。

エンジンバージョンの手動アップグレード

ブローカーのエンジンバージョンは、 AWS マネジメントコンソール、、 AWS CLIまたは Amazon MQ API を使用してアップグレードできます。

を使用してブローカーのエンジンバージョンをアップグレードするには AWS マネジメントコンソール
  1. ブローカーの詳細ページで [Edit] (編集) をクリックします。

  2. [Specifications] (仕様) の [Broker engine version] (ブローカーエンジンバージョン) で、ドロップダウンリストから新しいバージョン番号を選択します。

  3. ページの最下部までスクロールして、[Schedule modifications] (変更をスケジュールする) をクリックします。

  4. [Schedule broker modifications] (ブローカー変更のスケジュール) ページの [When to apply modifications] (変更を適用するタイミング) で以下のいずれかを選択します。

    • 次にスケジュールされたメンテナンスウィンドウ中に Amazon MQ でバージョンアップグレードを完了する場合は、[After the next reboot] (次回の再起動後) を選択します。

    • 直ちにブローカーを再起動してエンジンバージョンをアップグレードする場合は、[Immediately] (即時) を選択します。

      重要

      再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

  5. [Apply] (適用) をクリックして、変更の適用を終了します。

を使用してブローカーのエンジンバージョンをアップグレードするには AWS CLI
  1. 以下の例にあるように、update-broker CLI コマンドを使用して、以下のパラメータを指定します。

    • --broker-id – Amazon MQ がブローカー用に生成する一意の ID です。ID は、ブローカー ARN から解析できます。例えば、arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9 という ARN の場合、ブローカー 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 がブローカーをアップグレードします。

    重要

    再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

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 がブローカーをアップグレードします。

    重要

    再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。