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

Amazon MQ は、ハードウェア、オペレーティングシステム、エンジンソフトウェア、またはメッセージブローカーに対して定期的にメンテナンスを実行します。メンテナンスの所要時間はさまざまですが、メッセージブローカーに対してスケジュールされている操作によっては、最長 2 時間継続することがあります。例えば、エンジンの自動マイナーバージョンアップグレードをアクティブ化した場合、またはブローカーインスタンスタイプを変更した場合、Amazon MQ は次にスケジュールされているメンテナンスウィンドウ中に変更を適用します。

メンテナンスウィンドウ中のダウンタイムを最小限に抑えるため、複数のアベイラビリティーゾーン (AZ) にまたがる、高可用性を備えたブローカーデプロイモードを選択することをお勧めします。ブローカーのエンジンタイプに応じて、Amazon MQ は以下のマルチ AZ 配置モードを提供します。

Amazon MQ for ActiveMQ – Amazon MQ for ActiveMQ は、高可用性のためにアクティブ/スタンバイデプロイを提供します。アクティブ/スタンバイモードでは、Amazon MQ がメンテナンス操作を一度に 1 インスタンスずつ実行して、少なくとも 1 つのインスタンスが利用可能であることを保証します。さらに、メンテナンスウィンドウが 1 週間のさまざまな時点に分散されたブローカーのネットワークを設定することもできます。
Amazon MQ for RabbitMQ – Amazon MQ for RabbitMQ は、高可用性のためにクラスターデプロイを提供します。クラスターデプロイでは、Amazon MQ がメンテナンス操作を一度に 1 ノードずつ実行して、少なくとも 2 つのノードが常に実行され続けるようにします。

メンテナンスウィンドウ中、またはその後もブローカーが効率的に動作することを確実にするための Amazon MQ の推奨ベストプラクティスに関する詳細については、ブローカーのエンジンタイプに対応する以下のドキュメントを参照してください。

メンテナンスは週に 1 回、指定された時刻に実行されるようにスケジュールでき、最長で 2 時間かかります。これは、Amazon MQ からのメンテナンスアクションがスケジュールされ、開始される時間帯を設定します。

メンテナンスウィンドウは、ブローカーを初めて作成するときにスケジュールする、またはブローカー設定を更新することによってスケジュールすることができます。次のトピックでは、 AWS Management Console、 AWS CLI、および Amazon MQ を使用してブローカーメンテナンスウィンドウを調整する方法について説明しますAPI。

トピック

ブローカーメンテナンスウィンドウの調整

ブローカーメンテナンスウィンドウの調整

選択したメンテナンスウィンドウ中に、Amazon MQ は自動マイナーバージョンアップグレードなど、保留中の変更を実行します。ブローカーのメンテナンスウィンドウを調整するには、、 AWS Management Console、 AWS CLIまたは Amazon MQ を使用できますAPI。

重要

ブローカーのメンテナンスウィンドウは、次にスケジュールされたメンテナンスウィンドウまで、最大 4 回しか調整できません。Amazon MQ は、重要なソフトウェアパッチとセキュリティパッチ、および重要なハードウェアアップグレードが無期限に延期されることがないように、メンテナンスウィンドウの調整を 4 回に制限します。

ブローカーメンテナンスウィンドウが完了すると、Amazon MQ がこの制限をリセットするため、次回のメンテナンスウィンドウまでスケジュールを調整できるようになります。

ブローカーの可用性は、ブローカーのメンテナンスウィンドウを調整しても影響を受けません。

を使用してブローカーのメンテナンスウィンドウを調整するには AWS Management Console

Amazon MQ コンソールにサインインします。
左のナビゲーションペインで、[Brokers] (ブローカー) をクリックしてから、アップグレードするブローカーをリストから選択します。
ブローカーの詳細ページで [Edit] (編集) をクリックします。
[Maintenance] (メンテナンス) で、以下を実行します。
1. [Start day (開始日)] には、ドロップダウンリストから曜日を選択します ([Sunday (日曜日)] など)。
2. [Start time (開始時刻)] には、次回のブローカーメンテナンスウィンドウをスケジュールする時間と分を選択します (12:00 など)。
  
  注記
  開始時間オプションは UTC+0 タイムゾーンで設定されます。
ページの最下部までスクロールし、[Save] (保存) をクリックします。メンテナンスウィンドウは直ちに調整されます。
ブローカーの詳細ページにある [Maintenance window (メンテナンスウィンドウ)] で、希望する新しいスケジュールが表示されていることを確認します。

を使用してブローカーのメンテナンスウィンドウを調整するには AWS CLI

update-broker CLI コマンドを使用して、例に示すように、次のパラメータを指定します。
- --broker-id – Amazon MQ がブローカー用に生成する一意の ID です。ブローカーから ID を解析できますARN。例えば、次の ARN、の場合arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9、ブローカー ID はになりますb-1234a5b6-78cd-901e-2fgh-3i45j6k178l9。
- --maintenance-window-start-time – 以下の構造で提供される、週次メンテナンスウィンドウの開始時刻を決定するパラメータです。
  - DayOfWeek– MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY の構文で指定する曜日です。
  - TimeOfDay – 24 時間形式の時刻です。
  - TimeZone – (オプション) 国/都市、またはUTCオフセット形式のタイムゾーン。デフォルトでは UTC に設定されます。
```
aws mq update-broker --broker-id broker-id \
--maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles
```
（オプション) describe-broker CLI コマンドを使用して、メンテナンスウィンドウが正常に更新されていることを確認します。
```
aws mq describe-broker --broker-id broker-id
```

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: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string
```
リクエストペイロードには、maintenanceWindowStartTime パラメータと WeeklyStartTime リソースタイプを使用します。
```
{
"maintenanceWindowStartTime": {
    "dayOfWeek": "SUNDAY",
    "timeZone": "America/Los_Angeles",
    "timeOfDay": "13:00"
  }
}
```
（オプション) DescribeBrokerAPIオペレーションを使用して、メンテナンスウィンドウが正常に更新されたことを確認します。 broker-idはパスパラメータとして指定されます。
```
GET /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string
```

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

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

ドキュメントの表記規則

ブローカーの管理

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