インスタンス可用性ポリシーの設定

Compute Engine で、インフラストラクチャの定期メンテナンスを行います。このページでは、このメンテナンスイベントの種類とおおよその頻度について説明します。また、インスタンスの可用性オプションを設定して、メンテナンスイベントが発生したときの VM インスタンスの動作を構成する方法についても説明します。このページでは、メンテナンスイベントの発生時にインスタンスにライブマイグレーションを設定する方法についても説明します。

始める前に

このガイドのコマンドラインの例を使用する場合、以下を行ってください。
1. gcloud コマンドラインツールの最新バージョンをインストールするか、最新バージョンに更新します。
2. デフォルトのリージョンとゾーンを設定します。
このガイドの API の例を使用する場合、API アクセスを設定します。

メンテナンスイベント

Compute Engine のメンテナンスイベントでは、ハードウェアとソフトウェアを更新します。メンテナンスイベントによっては、メンテナンス中のホストから VM を移動する必要がありますが、これらのインスタンスのスケジューリング動作は Compute Engine によって自動的に管理されます。インスタンスの可用性ポリシーでライブマイグレーションの使用を構成した場合は、Compute Engine が VM インスタンスのライブマイグレーションを行います。これにより、イベント発生中のアプリケーションの中断を防ぐことができます。また、ライブマイグレーションを行わず、イベント発生中にインスタンスを停止することもできます。

次の表では、Compute Engine のメンテナンスイベントをおおまかに 2 つに分類しています。それぞれで例を示し、どちらのメンテナンスイベントで VM を別のホストにライブマイグレーションする必要があるかを示しています。

メンテナンスイベントのタイプ	例	おおよその頻度 ^*	新しいホストへのライブマイグレーションが必要
ホストメンテナンス	ホストカーネルのアップグレード、ハードウェアの修理またはアップグレード	2 週間に 1 回	○
簡易メンテナンス	ハイパーバイザーレベルのアップグレード、ネットワークスタックのアップグレード	1 週間に 1～2 回	×

^{* これはおおよその頻度であり、実施を保証するものではありません。Compute Engine は記載内容よりも高い頻度でメンテナンスを実施することがあります。}

可用性ポリシーの選択

Google が別のホストマシンに VM インスタンスを移動することが必要となるイベントが発生した場合は、VM インスタンスの可用性ポリシーによりその動作を指定します。Compute Engine が別のホストへのライブマイグレーションを行っている間、VM インスタンスの実行を継続するように構成できます。インスタンスの可用性ポリシーは VM インスタンスの動作を定義します。このポリシーは、必要なときにいつでも更新できます。

インスタンスの可用性ポリシーを変更する場合、次の 2 つの構成を行います。

VM インスタンスのメンテナンス動作。メンテナンスイベントが発生した場合に、インスタンスをライブマイグレーションするか停止するかを設定します。
インスタンスの再起動動作。インスタンスがクラッシュまたは停止した場合に、インスタンスを自動的に再起動するかどうかを設定します。

デフォルトのメンテナンス動作では、インスタンスがライブマイグレーションされますが、メンテナンスイベント中にインスタンスを停止するよう設定を変更することもできます。

ライブマイグレーション

デフォルトでインスタンスがライブマイグレーションされるよう設定されているため、インスタンスはインフラストラクチャのメンテナンスイベントの影響を受けることなく Compute Engine によって自動的に移行されます。インスタンスは移行中も実行されます。通常は、ほとんどのインスタンスが影響を受けませんが、まれにインスタンスのパフォーマンスが一時的に低下する場合があります。この設定は、継続的な稼働を必要とし、一時的なパフォーマンスの低下に対応できるインスタンスに適しています。

インスタンスを移行する際、Compute Engine はゾーンオペレーションのリストに公開されているシステムイベントを報告します。このイベントを確認するには、特定のゾーンに対する Compute Engine のオペレーションを表示します。ライブマイグレーションイベントには、次のオペレーションタイプがあります。

compute.instances.migrateOnHostMaintenance

停止と（必要に応じた）再起動

インスタンスをライブマイグレーションしない場合は、インスタンスを停止し、必要に応じて再起動するよう設定できます。このオプションでは、Compute Engine がインスタンスにシャットダウンするよう信号を送り、インスタンスが完全にシャットダウンするのを待ってからインスタンスを停止して、メンテナンスイベントの終了後に再起動します。このオプションは、インスタンスが常に最大限のパフォーマンスを要求し、すべてのアプリケーションがインスタンス障害や再起動に対処するように構築されている場合に最適です。

インスタンスを停止して再起動すると、Compute Engine はゾーンオペレーションのリストに公開されるシステムイベントを報告します。このイベントを確認するには、特定のゾーンに対する Compute Engine のオペレーションを表示します。停止されたイベントは、次のオペレーションタイプで示されます。

compute.instances.terminateOnHostMaintenance

インスタンスを再起動するときは、前と同じ永続ブートディスクを使用し、構成されているセカンダリ永続ディスクを再アタッチします。それらのディスク上のデータは、インスタンスの移行や再起動の後も維持されます。

ローカルの SSD データは、インスタンスの停止後は維持されません。インスタンスが再起動したときには、新しいローカル SSD が作成されるので、それをフォーマットしてマウントする必要があります。

自動再起動

メンテナンスイベントが発生したとき、またはハードウェアの根本的な問題でインスタンス障害が起きたときにインスタンスを停止するよう設定されている場合、automaticRestart フィールドを true に設定すると、Compute Engine がインスタンスを自動的に再起動します。この設定は、sudo shutdown の呼び出しなどのユーザー操作によってインスタンスがオフラインになった場合には適用されません。

インスタンスを自動的に再起動する際、Compute Engine はゾーンオペレーションのリストに公開されているシステムイベントを報告します。このイベントを確認するには、特定のゾーンに対する Compute Engine のオペレーションを表示します。自動再起動イベントには、次のオペレーションタイプがあります。

compute.instances.automaticRestart

Compute Engine のオペレーションの表示

Google Cloud Console、gcloud コマンドラインツール、Compute Engine API を使用して、完了したオペレーションの一覧を表示できます。

Console

プロジェクトのオペレーションの一覧を表示するには、[オペレーション] ページに移動します。

[オペレーション] ページに移動します。
オペレーションの詳細については、[オペレーションの概要] をクリックしてください。たとえば、my-instance インスタンスの移行の詳細を表示するには、[インスタンスの自動移行] オペレーションをクリックします。

gcloud

gcloud compute を使用してプロジェクトのオペレーションの一覧を表示するには、operations list サブコマンドを使用します。

指定したゾーン内のオペレーションの一覧を表示するには、--filter フラグを追加します。

gcloud compute operations list --filter="zone:(ZONE)"

ZONE は、オペレーションの一覧を表示するゾーンに置き換えます。たとえば、us-cental1-c でのオペレーションの一覧を表示するには、次のコマンドを実行します。

gcloud compute operations list --filter="zone:(us-central1-c)"

NAME                            TYPE                                        TARGET                                HTTP_STATUS  STATUS  TIMESTAMP
systemevent-1543845145000...    compute.instances.migrateOnHostMaintenance  us-central1-c/instances/my-instance   200          DONE    2018-12-03T05:52:25.000-08:00

API

オペレーションに対する API リクエストは、グローバル、リージョン、ゾーンのいずれかのレベルで指定する必要があります。ライブマイグレーション、インスタンスの停止、自動再起動はすべてゾーンレベルのオペレーションです。

ゾーンオペレーションの場合は、zoneOperations.list メソッドに GET リクエストを発行します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations

以下のように置き換えます。

PROJECT_ID: このリクエストのプロジェクト ID
ZONE: このリクエストのゾーン

リクエスト本文は空のままにします。

以下はゾーンオペレーションリクエストの出力例です。この出力では、ホストの移行に関する詳細が表示されています。

{
 "kind": "compute#operation",
 "id": "3216798767364213712",
 "name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
 "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
 "operationType": "compute.instances.migrateOnHostMaintenance",
 "targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
 "targetId": "3070988523247098025",
 "status": "DONE",
 "statusMessage": "Instance migrated during Compute Engine maintenance.",
 "user": "system",
 "progress": 100,
 "insertTime": "2018-12-03T05:52:25.000-08:00",
 "startTime": "2018-12-03T05:52:25.000-08:00",
 "endTime": "2018-12-03T05:52:25.000-08:00",
 "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}

可用性ポリシーの設定

onHostMaintenance プロパティと automaticRestart プロパティを使ってインスタンスのメンテナンス動作と自動再起動を構成します。明示的に指定しない限り、すべてのインスタンスはデフォルト値に設定されます。

onHostMaintenance: インスタンスの再起動が必要になるメンテナンスイベントが発生したときの動作を指定します。
- [デフォルト] MIGRATE では、Compute Engine はメンテナンスイベント発生時にインスタンスをライブマイグレーションします。
- TERMINATE では、インスタンスを移行せずに停止します。
automaticRestart: インスタンスがクラッシュしたか、システムによって停止した場合の動作を指定します。
- [デフォルト] true では、インスタンスがクラッシュまたは停止した場合、Compute Engine はインスタンスを再起動します。
- false では、インスタンスがクラッシュまたは停止しても、Compute Engine はインスタンスを再起動しません。

インスタンスの可用性ポリシーは、最初のインスタンス作成時か、インスタンス作成後に setScheduling メソッドを使用して変更できます。

インスタンス作成時のオプションの設定

Console

Cloud Console で、[インスタンスの作成] ページに移動します。
[インスタンスの作成] に移動
[新しいインスタンスの作成] ページで、インスタンスのプロパティを入力します。

[管理、セキュリティ、ディスク、ネットワーク、単一テナンシー] オプションを展開します。
[可用性ポリシー] で、[自動再起動] と [ホストメンテナンス時] オプションを設定します。
[作成] をクリックしてインスタンスを作成します。

gcloud

gcloud compute で新しいインスタンスの可用性ポリシーを指定するには、--maintenance-policy フラグを使用して、インスタンスの移行または停止を指定します。--no-restart-on-failure フラグを設定しない限り、インスタンスは自動的に再起動するようにデフォルトで設定されています。

gcloud compute instances create INSTANCE_NAME \
    --maintenance-policy MAINTENANCE_POLICY \
    [--no-restart-on-failure]

以下のように置き換えます。

INSTANCE_NAME: インスタンス名
MAINTENANCE_POLICY: このインスタンスのポリシー。TERMINATE または MIGRATE のいずれか。

API

API で以下の URL への POST リクエストを行い、プロジェクトとゾーンを自分のプロジェクト ID とインスタンスのゾーンに書き換えます。

https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

onHostMaintenance パラメータと automaticRestart パラメータは、リクエスト本文の一部として送信します。

{
  "name": "example-instance",
  "description": "Front-end for real-time ingest; don't migrate.",
  ...
  // User options for influencing this Instance’s life cycle.
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true
  }
}

詳しくは、インスタンスの参照ドキュメントをご覧ください。

インスタンスのオプションの更新

Console

Google Cloud Console の [VM インスタンス] ページに移動します。
[VM インスタンス] ページに移動
設定を変更するインスタンスをクリックします。インスタンスの詳細ページが表示されます。
インスタンスの詳細ページで、次の手順を実行します。
1. ページの上部にある [編集] ボタンをクリックします。
2. [可用性ポリシー] で、必要に応じてポリシーを更新します。[可用性ポリシー] セクションから、[ホストメンテナンス時] と [自動再起動] オプションを設定できます。
3. [保存] をクリックします。

gcloud

インスタンスの可用性ポリシーを更新するには、上記のインスタンス作成コマンドで使用したのと同じパラメータとフラグを指定して instances set-scheduling コマンドを使用します。

gcloud compute instances set-scheduling INSTANCE_NAME \
    --maintenance-policy MAINTENANCE_POLICY \
    [--no-restart-on-failure | --restart-on-failure]

以下のように置き換えます。

INSTANCE_NAME: インスタンス名
MAINTENANCE_POLICY: このインスタンスのポリシー。TERMINATE または MIGRATE のいずれか。

API

API で、以下の URL にリクエストを送信します。プロジェクト ID、ゾーン、インスタンス名は実際のプロジェクト ID、ゾーン、インスタンス名に置き換えます。

https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/example-instance/setScheduling

リクエストの本文には、可用性ポリシーの新しい値を含める必要があります。

{
  "onHostMaintenance": "MIGRATE",
  "automaticRestart": true
}

詳細については、instances().setScheduling リファレンスドキュメントをご覧ください。

可用性ポリシーのテスト

可用性ポリシーの設定後、メンテナンスイベントをシミュレートして、アプリケーションに対するこれらの可用性ポリシーの影響をテストできます。たとえば、次のいずれかの状況において、インスタンスでメンテナンスイベントをシミュレートする場合があります。

メンテナンスイベント中にライブマイグレーションするように構成されたインスタンスがあり、アプリケーションに対するライブマイグレーションの影響をテストする必要がある。
プリエンプティブ VM インスタンスで実行されるバッチジョブがあり、インスタンスのプリエンプションおよびシャットダウンがアプリケーションによってどのように処理されるかをテストする必要がある。
メンテナンスイベント中にライブマイグレーションするのではなく、停止して再起動するようにインスタンスが構成されていて、このシャットダウンと再起動のプロセスがアプリケーションによってどのように処理されるかをテストする必要がある。

シミュレートメンテナンスイベントには決められた API レート制限が適用されます。

gcloud コマンドラインツールまたは API リクエストを使用して、インスタンスでメンテナンスイベントをシミュレートできます。

gcloud

instances simulate-maintenance-event コマンドを実行して、インスタンスでその構成済みメンテナンスポリシー処理を有効にします。

gcloud compute instances simulate-maintenance-event INSTANCE_NAME \
    --zone ZONE

以下のように置き換えます。

INSTANCE_NAME: メンテナンスイベントをシミュレートするインスタンスの名前。同じゾーン内の複数のインスタンスでメンテナンスイベントをシミュレートするには、インスタンス名を 1 個のスペースで区切って指定します。例: instance-1 instance-2 instance-3
ZONE: インスタンスが配置されているゾーン。

API

API では、Compute Engine API の compute.instances.simulateMaintenanceEvent メソッドに対してリクエストします。

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

以下のように置き換えます。

PROJECT_ID: このリクエストのプロジェクト ID
INSTANCE_NAME: メンテナンスイベントをシミュレートするインスタンスの名前
ZONE: インスタンスが配置されているゾーン

このメソッドの詳細については、instances().simulateMaintenanceEvent リファレンスドキュメントをご覧ください。

次のステップ

ライブマイグレーションの詳細を見る。
ライブマイグレーションイベントを検出する方法を学習する。

インスタンス可用性ポリシーの設定

始める前に

メンテナンス イベント

可用性ポリシーの選択

ライブ マイグレーション

停止と（必要に応じた）再起動

自動再起動

Compute Engine のオペレーションの表示

Console

gcloud

API

可用性ポリシーの設定

インスタンス作成時のオプションの設定

Console

gcloud

API

インスタンスのオプションの更新

Console

gcloud

API

可用性ポリシーのテスト

gcloud

API

次のステップ

メンテナンスイベント

ライブマイグレーション