エンジンバージョンの手動アップグレードマイナーエンジンバージョンの自動アップグレードエンジンバージョンのサポート終了カレンダー

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

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

Amazon MQ は、セマンティックバージョニング仕様に従ってバージョン番号をとして整理しますX.Y.Z。Amazon MQ 実装では、 X はメジャーバージョン、 Yはマイナーバージョン、 Zはパッチバージョン番号を表します。アップグレードには以下の 2 つのタイプがあります。

メジャーバージョンアップグレード – メジャーエンジンバージョン番号が変更されたときに行われます。例えば、バージョン 1.0 からバージョン 2.0 へのアップグレードは、メジャーバージョンのアップグレードと見なされます。
マイナーバージョンアップグレード — マイナーエンジンまたはパッチエンジンのバージョン番号のみが変更されたときに発生します。例えば、バージョン 1.5 からバージョン 1.6 へのアップグレードは、マイナーバージョンアップグレードと見なされます。

特定のブローカーエンジンタイプごとのメジャーバージョン管理とマイナーバージョン管理の詳細については、以下のトピックを参照してください。

ブローカーは、いつでも、次にサポートされているメジャー、マイナー、またはパッチバージョンに手動でアップグレードできます。自動マイナーバージョンアップグレードを有効にすると、Amazon MQ はメンテナンスウィンドウ中にブローカーをサポートされている最新のパッチバージョンにアップグレードします。 Amazon MQ 自動マイナーバージョンアップグレードを有効にしない場合、現在のマイナーバージョンがサポート終了になると、Amazon MQ はブローカーを次のマイナーバージョンにアップグレードします。

手動および自動のバージョンアップグレードは、どちらもスケジュールされたメンテナンスウィンドウ中、またはブローカーの再起動後に行われます。

以下のトピックでは、ブローカーエンジンバージョンを手動でアップグレードする方法と、自動マイナーバージョンアップグレードをアクティブにする方法について説明します。

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

ブローカーのエンジンバージョンを新しいメジャーバージョンまたはマイナーバージョンに手動でアップグレードするには、、 AWS CLI、または Amazon MQ API AWS Management Consoleを使用できます。

を使用してブローカーのエンジンバージョンをアップグレードするには AWS Management Console

Amazon MQ コンソールにサインインします。
左のナビゲーションペインで、[Brokers] (ブローカー) をクリックしてから、アップグレードするブローカーをリストから選択します。
ブローカーの詳細ページで [Edit] (編集) をクリックします。
[Specifications] (仕様) の [Broker engine version] (ブローカーエンジンバージョン) で、ドロップダウンリストから新しいバージョン番号を選択します。
ページの最下部までスクロールして、[Schedule modifications] (変更をスケジュールする) をクリックします。
[Schedule broker modifications] (ブローカー変更のスケジュール) ページの [When to apply modifications] (変更を適用するタイミング) で以下のいずれかを選択します。
- 次にスケジュールされたメンテナンスウィンドウ中に Amazon MQ でバージョンアップグレードを完了する場合は、[After the next reboot] (次回の再起動後) を選択します。
- 直ちにブローカーを再起動してエンジンバージョンをアップグレードする場合は、[Immediately] (即時) を選択します。
  
  重要
  再起動中、ブローカーはオフラインになります。
[Apply] (適用) をクリックして、変更の適用を終了します。

を使用してブローカーのエンジンバージョンをアップグレードするには AWS CLI

以下の例にあるように、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
```
(オプション) エンジンバージョンを直ちにアップグレードする場合は、reboot-broker CLI コマンドを使用してブローカーを再起動します。
```
aws mq reboot-broker --broker-id broker-id
```
直ちにブローカーを再起動して変更を適用しない場合は、次にスケジュールされたメンテナンスウィンドウ中に Amazon MQ がブローカーをアップグレードします。

重要
再起動中、ブローカーはオフラインになります。

Amazon MQ API を使用してブローカーのエンジンバージョンをアップグレードする

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"
}
```
（オプション) エンジンバージョンをすぐにアップグレードする場合は、 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 がブローカーをアップグレードします。

重要
再起動中、ブローカーはオフラインになります。

マイナーエンジンバージョンの自動アップグレード

ブローカーの自動マイナーバージョンアップグレードを、初めてブローカーを作成するときにアクティブにするか、ブローカー設定を変更することによってアクティブにするかは、ユーザーが制御できます。既存のブローカーの自動マイナーバージョンアップグレードを有効にするには、、 AWS CLI、または Amazon MQ API AWS Management Consoleを使用できます。

を使用して自動マイナーバージョンアップグレードを有効にするには AWS Management Console

Amazon MQ コンソールにサインインします。
左のナビゲーションペインで、[Brokers] (ブローカー) をクリックしてから、アップグレードするブローカーをリストから選択します。
ブローカーの詳細ページで [Edit] (編集) をクリックします。
[Maintenance] (メンテナンス) で、[Enable automatic minor version upgrades](自動マイナーバージョンアップグレードの有効化) を選択します。

注記
このオプションが既に選択されている場合は、何も変更する必要はありません。
ページの最下部で [Save] (保存) をクリックします。

経由で自動マイナーバージョンアップグレードを有効にするには AWS CLI、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 になります。
--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 エンドポイントの詳細については、「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" を設定します。

エンジンバージョンのサポート終了カレンダー

Amazon MQ バージョンのサポート終了カレンダーは、ブローカーエンジンのバージョンがサポート終了になると通知します。エンジンバージョンのサポートが終了すると、Amazon MQ はこのバージョンのすべてのブローカーを次に利用可能なバージョンに自動的に更新します。Amazon MQ は、エンジンバージョンがサポートを終了する少なくとも 90 日前に通知します。

バージョンサポートカレンダーを表示するには、Amazon MQ Amazon MQ for ActiveMQ エンジンバージョンの管理 for ActiveMQ」とAmazon MQ Amazon MQ for RabbitMQ エンジンバージョンの管理 for RabbitMQ」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ブローカーのメンテナンス

ブローカーステータス