ホスト メンテナンス イベントをシミュレーションする

このページでは、Compute Engine インスタンスのホスト メンテナンス ポリシーがアプリケーションに及ぼす影響をテストする方法について説明します。

VM 上でメンテナンス イベントをシミュレートして、次の項目をテストできます。

• アプリケーションに対するライブ マイグレーションの影響。
• 1 つ以上の Spot VM を使用する場合、アプリケーションとバッチジョブでプリエンプションとシャットダウンがどのように処理されるか。
• メンテナンス イベントでライブ マイグレーションせずに終了して再起動するように構成されているインスタンスで、シャットダウンと再起動のプロセスがアプリケーションでどのように処理されるか。
• ホスト メンテナンス イベント中に、単一テナントノードで実行中のワークロードが示す動作。また、単一テナント VM で実行中のアプリケーションに対し、その VM のホスト メンテナンス ポリシーが及ぼす影響。

ライブ マイグレーションをサポートしていないインスタンスでホスト メンテナンス イベントをシミュレートしようとすると、構成されたホスト メンテナンス ポリシーに応じて、そのインスタンスは終了または再起動します。

始める前に

• SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion のリージョン API レート制限を確認します。
• まだ設定していない場合は、認証を設定します。認証とは、 Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
  

  Select the tab for how you plan to use the samples on this page:

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

制限事項

• ノードグループでの移行に設定されたホスト メンテナンス ポリシーを持つ単一テナントノード グループで、メンテナンス イベントを正しくシミュレートするには、それらのノードごとにメンテナンス イベントを順番にトリガーする必要があります。
• 単一テナントノード グループでホスト メンテナンス イベントをシミュレートしようとするとき、そのノードグループのホスト メンテナンス ポリシーがノードグループでの移行に設定されている場合:
  • 指定したノード数が予約済みホールドバック ノードの合計数以下である場合、指定したすべてのノードに対してホスト メンテナンス イベントのシミュレーションが同時に実行されます。
  • 指定したノード数が予約済みホールドバック ノードの合計数より多い場合、シミュレーションは失敗します。
• リージョン単位で 1 分あたりに開始できるメンテナンス イベント シミュレーションの数は、simulate_maintenance_event_requests_per_region 指標の API レート制限で制限されます。

ホスト メンテナンス イベントをシミュレートしてライブ マイグレーションをテストする

Google Cloud CLI または API リクエストを使用して、コンピューティング インスタンスのメンテナンス イベントをシミュレートできます。このようにシミュレートしたイベントでは、通常のメンテナンス イベントで発生するさまざまなメンテナンス アクティビティが同様に発生します。これにより、エンドツーエンドのプロセスをモニタリングし、実装した自動化をテストできます。

ライブ マイグレーションを使用するインスタンスでのホスト メンテナンス イベントのシミュレーションでは、そのインスタンスの maintenance-event メタデータキーが次のように変更されます。

1. シミュレーションの開始時、maintenance-event メタデータキーの値が NONE から MIGRATE_ON_HOST_MAINTENANCE に変わります。
2. シミュレーション イベントの間は MIGRATE_ON_HOST_MAINTENANCE のままです。
3. シミュレーションが終了すると値は NONE に戻ります。

メンテナンス イベントキーをクエリするには、メンテナンス イベントのメタデータキーをクエリするをご覧ください。

gcloud compute instances simulate-maintenance-event INSTANCE_NAME \
    --zone=ZONE --with-extended-notifications=True

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/simulateMaintenanceEvent

終了するコンピューティング インスタンスのホスト メンテナンンスをシミュレートする

Google Cloud CLI または API リクエストを使用して、コンピューティング インスタンスのメンテナンス イベントをシミュレートできます。このようにシミュレートしたイベントでは、通常のメンテナンス イベントで発生するさまざまなメンテナンス アクティビティが同様に発生します。これにより、エンドツーエンドのプロセスをモニタリングし、実装した自動化をテストできます。

また、サポートされているマシンタイプを指定したパラメータ --with-extended-notifications を使用すると、シミュレートしたイベント中にホスト メンテナンスの開始を手動でテストできます。

単一テナントノードでホスト メンテナンス イベントをシミュレートする

Google Cloud CLI または API リクエストを使用して、単一テナントノードでホスト メンテナンス イベントをシミュレートできます。単一テナント VM のホスト メンテナンス イベントのシミュレーション中、maintenance-event メタデータキーの値は変更されず、シミュレーション中も NONE のままです。

 gcloud compute sole-tenancy node-groups simulate-maintenance-event NODE_GROUP \
    --nodes=NODE_NAMES \
    --zone=ZONE \
    --async

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/NODE_GROUP/simulateMaintenanceEvent

{
  "nodes": [
      "NODE_NAMES"
  ]
}

次のステップ

• ホストイベントの詳細を確認する。
• 単一テナントノードでのホスト メンテナンスの詳細を確認する。
• VM ホスト メンテナンス ポリシー オプションの設定の詳細を確認する。
• VM オペレーションを表示する方法を学習する。
• マルチテナンシーと単一テナンシーの詳細を確認する。