単一テナントノードへの高度なメンテナンス管理を有効にする

単一テナントに対する高度なメンテナンス管理を使用すると、単一テナントノード グループの計画的なメンテナンス イベントを制御し、メンテナンス関連の中断を最小限に抑えることができます。この機能は、単一テナントノード グループでのみ使用できます。既存の仮想マシンでこの機能を使用するには、まず、高度なメンテナンス管理が有効になっている単一テナントノード グループに VM を移動する必要があります。

単一テナンシーに対する高度なメンテナンス管理機能により、次のことが可能になります。

• 28 日前に単一テナントノードの定期メンテナンス イベントを確認する。
• メンテナンスを直ちにトリガーするか、後で実行するようにスケジュールします。メンテナンスを直ちにトリガーすると、リクエストをトリガーしてから 6 時間以内にメンテナンスが実施されます。

高度なメンテナンス管理を使用する単一テナントノード グループを作成するプロセスは次のとおりです。

1. 互換性のある単一テナントノード グループで、高度なメンテナンス管理にオプトインします。この機能は、単一テナントノード グループでのみ使用できます。既存の VM または単一テナントのワークロードでこの機能を使用するには、まず、高度なメンテナンス管理が有効になっている単一テナントノード グループに VM を移動する必要があります。

2. 単一テナントノードの今後のメンテナンスを確認します。単一テナントノードのメンテナンスは、最大で 28 日ごとに行われます。ノードのメンテナンス イベントを確認できるのは、そのノードのメンテナンスがスケジュールされている 6 時間のメンテナンスの時間枠が始まる 28 日前です。

3. 単一テナントノードのメンテナンスがスケジュールされている場合、スケジュールされたメンテナンスの時間枠が開始される前に、次のことができます。

   • メンテナンスを直ちにトリガーするか、後で実行するようにスケジュールします。メンテナンスを直ちにトリガーする場合は、リクエストをトリガーしてから 6 時間以内にメンテナンスが行われます。選択する予定日時は、最初のメンテナンスの時間枠の開始時刻よりも前である必要があります。

   • メンテナンスを直ちにトリガーしない場合や、後で実行するようにスケジュールする場合は、メンテナンスは最初のメンテナンスの時間枠で指定された時間内に行われます。

高度なメンテナンス管理を有効にして、単一テナントノード グループを自動スケーリングすることができます。すべての場合で監査ログが生成されます。

サポートされているマシン ファミリー

単一テナントノードの高度なメンテナンス管理は、次のマシン ファミリーでサポートされています。

• M2 ファミリー: 一般提供
• M1、M3、C2、N2 ファミリー: プレビュー版

制限事項

単一テナンシー機能に対する高度なメンテナンス管理の制限事項は次のとおりです。

• ローカル SSD と GPU: この機能でローカル SSD と GPU はサポートされていません。
• メンテナンス ポリシー: この機能は、デフォルトのメンテナンス ポリシー（ライブ マイグレーション）をサポートしています。再起動（BYOLv1）やノードグループ内で移行（BYOLv2）など、その他のメンテナンス ポリシーはサポートされていません。
• ノード: この機能では、1 プロジェクト、1 ゾーンあたり最大 20 個のノードをサポートできます。
• 既存の単一テナントノードの高度なメンテナンス管理: 高度なメンテナンス管理を行うために既存の単一テナントノード グループにオプトインすることはできません。高度なメンテナンス管理が有効になっている単一テナントノード グループで既存のワークロードを実行する場合は、まず高度なメンテナンス管理を有効にして新しいノードグループを作成してから、ワークロードをこのグループに移行する必要があります。同様に、高度なメンテナンス管理からオプトアウトするには、高度なメンテナンス管理が有効になっていない単一テナントノード グループに単一テナントノードを移行する必要があります。
• 現在のメンテナンス ポリシーへの影響: この機能にオプトインすると、単一テナントノードに関連付けられている既存のメンテナンスの時間枠がオーバーライドされます。

費用

単一テナントノードで高度なメンテナンス管理を使用する場合、追加費用はかかりません。

準備

• 単一テナントノードで VM をプロビジョニングする前に、割り当てを確認します。予約するノードの数とサイズによっては、割り当て量の追加リクエストが必要になる場合があります。
• まだ設定していない場合は、認証を設定します。認証とは、Google Cloud のサービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
  

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

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

単一テナントノードで高度なメンテナンス管理を有効にする

単一テナンシーの高度なメンテナンス管理はオプトイン機能であり、単一テナントノード グループでのみ使用できます。既存の VM または単一テナントのワークロードでこの機能を使用するには、まず、高度なメンテナンス管理が有効になっている単一テナントノード グループに VM を移動する必要があります。

gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \
--node-template=NODE_TEMPLATE_NAME \
--zone=NODE_GROUP_ZONE \
--target-size=NODE_GROUP_SIZE \
--maintenance-interval=RECURRENT

POST https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}

今後のメンテナンスの確認

単一テナントノードのメンテナンスは、最大で 28 日ごとに行われます。ノードのメンテナンス イベントを確認できるのは、そのノードのメンテナンスがスケジュールされている 6 時間のメンテナンスの時間枠が始まる 28 日前です。

gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \
--format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes

{
  …
  "items": [
    …
    {
      "name": string,
      "status": string,
      …
      "upcomingMaintenance": {
        "canReschedule": boolean,
        "maintenanceType": enum, // SCHEDULED | UNSCHEDULED
        "windowStartTime": string, // RFC 3339 timestamp string
        "windowEndTime": string, // RFC 3339 timestamp string
        "latestWindowStartTime": string, // RFC 3339 timestamp string
        "maintenanceStatus": enum // PENDING | ONGOING
      },
      …
    },
    …
  ],
  …
}

メンテナンス イベントが表示されない場合は、ノードグループ内のノードにメンテナンスの予定がないことを意味します。

ノードのメンテナンスを直ちにトリガーする、またはメンテナンスをスケジュールする

単一テナントノード グループ内のどのノードにメンテナンスがスケジュールされているかが判明したら、次のいずれかを行います。

• メンテナンスを直ちにトリガーする。メンテナンスを直ちにトリガーする場合は、リクエストをトリガーしてから 6 時間以内にメンテナンスが行われます。

• 要件に基づいて、後で実行するようにメンテナンスをスケジュールします。

メンテナンスを直ちにトリガーしない場合や、後で実行するようにスケジュールする場合、メンテナンスは最初のメンテナンスの時間枠内に行われます。ノードのメンテナンスが開始されると、一時停止または再スケジュールすることはできません。

gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \
--zone=NODE_GROUP_ZONE \
--nodes=NODE_NAMES \
--window-start-time=WINDOW_START_TIME

POST
https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime":  "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}

ノードの [メンテナンス ステータス] フィールドに、メンテナンス プロセス中に次のステータスが表示されます。

• 保留中: メンテナンス オペレーションはまだ開始されていませんが、スケジュールされています。
• 進行中: メンテナンスの時間枠が開始されています。メンテナンス イベントは、ノードのメンテナンスが正常に完了するまで進行中のままです。

メンテナンス完了を確認する

M2 ノードのメンテナンス ステータスをクエリするには、gcloud compute sole-tenancy node-groups list-nodes コマンドまたは nodeGroups.listNodes メソッドを使用します。

詳しくは、メンテナンス ステータスの確認をご覧ください。

• メンテナンスが成功: 単一テナントノードのメンテナンスに成功すると、メンテナンス通知は削除されます。ノードグループ名をクエリすると、ノードの upcomingMaintenance セクションは存在しなくなります。
• メンテナンスに失敗: 6 時間の時間枠内にメンテナンスを完了できなかった場合、ノードのメンテナンスが完了するまで、メンテナンス イベントは進行中のままとなります。正常に完了すると、メンテナンス通知は削除されます。

指定した日時が単一テナントノードの高度なメンテナンス管理についての Google Cloud の内部上限を超えていると、選択した日時のメンテナンス トリガー リクエストが拒否されることがあります。この場合は、ノードのメンテナンスに別の日時を選択する必要があります。このノードの [メンテナンス ステータス] は [進行中] で、メンテナンスが正常に完了するまでその状態が続きます。

定期メンテナンスの日時を変更する

単一テナントノードの定期メンテナンスの日時は、ノードのメンテナンスをトリガーまたはスケジュールする場合と同じ手順で変更できます。