GKE on Bare Metal で VM のエビクションポリシーを構成する

このドキュメントは、GKE on Bare Metal で仮想マシン（VM）を実行するプラットフォーム管理者を対象としています。このドキュメントでは、Google Distributed Cloud 上の VM ランタイムを使用する VM がメンテナンスイベント中に他のホストに自動的に移行する方法を制御するエビクションポリシーの構成方法について説明します。これらの構成設定を使用すると、クラスタをアップグレードしたり、ホストでメンテナンスを行ったりしても、他のホストでは VM を継続して実行できます。

準備

このドキュメントの内容を最後まで行うには、GKE on Bare Metal バージョン 1.12.0（anthosBareMetalVersion: 1.12.0）以降のクラスタにアクセスする必要があります。ワークロードを実行可能な、どのクラスタタイプでも使用できます。必要に応じて、Compute Engine の GKE on Bare Metal を試すか、クラスタ作成の概要をご覧ください。

エビクションポリシーの設定

GKE on Bare Metal を使用すると、クラスタをアップグレードしたり、ノードをメンテナンスモードにする際のノードの動作を構成できます。Google Distributed Cloud 上の VM ランタイムは、これらのイベント中に実行される VM をクラスタがどのように取り扱うかを制御するエビクションポリシーを使用します。

有効にすると、Google Distributed Cloud 上の VM ランタイムはデフォルトでライブマイグレーションを使用して VM ワークロードを別のホストに移動します。この動作により、VM ワークロードが中断する可能性を最小限に抑えられます。ライブマイグレーションでは、ゲスト OS を中断することなく、移行可能な VM をあるホストから別のホストに移動します。

次のエビクションポリシー設定を構成できます。

プロパティ	デフォルト	有効な値
`evictionStrategy`	`LiveMigrate`	`LiveMigrate`、`Restart`
`maxMigrationAttemptsPerVM`	`3`	[`1`,`5`] の範囲内の整数
`migrationTargetInitializationTimeout`	`30s`	有効な長さの文字列（`1m`、`2h`、`1h30m`）

`evictionStrategy`

この値が LiveMigrate に設定されている場合、Google Distributed Cloud 上の VM ランタイムは、移行可能な VM をノードから移行して強制排除しようとします。VM はクラスタ内の別のノードに配置され、引き続き実行されます。

この値が Restart に設定されている場合、Google Distributed Cloud 上の VM ランタイムは VM の移行を試みません。代わりに、ノードがメンテナンスモードになると VM は停止し、ノードがメンテナンスモードから離れると VM が再起動します。ホストメンテナンスイベント中は VM が利用できなくなります。

LiveMigrate 戦略を選択すると、Google Distributed Cloud 上の VM ランタイムは、移行不能な VM では Restart 戦略にフォールバックします。

`maxMigrationAttemptsPerVM`

この設定は、Restart 戦略が適用される前に特定の VM に対して実行できる移行の試行の最大数を制御します。

evictionStrategy が Restart に設定されている場合、この設定は無視されます。

`migrationTargetInitializationTimeout`

この設定は、移行が失敗とみなされずに、移行が開始するまでにかけることができる最長時間を制御します。開始に時間がかかりすぎる移行は、VM ワークロードの移行予算にカウントされます。

evictionStrategy が Restart に設定されている場合、この設定は無視されます。

エビクションポリシーを有効にして構成する

Google Distributed Cloud 上の VM ランタイムでエビクションポリシーを使用するには、クラスタの VMRuntime オブジェクトで evictionPolicy 設定を定義する必要があります。この設定は、Anthos clusters on bare metal バージョン 1.12 以降でデフォルトで有効になっています。以前のバージョンからアップグレードする場合は、この設定を手動で有効にする必要があります。

空のオブジェクト（evictionPolicy: {} など）では、デフォルト設定でエビクションポリシーが有効になります。デフォルトの動作を変更するには、evictionPolicy オブジェクトに構成オプションを追加します。

エビクションポリシーを有効にして構成するには、次の手順を完了します。

VMRuntime カスタムリソースを編集します。
```
kubectl edit vmruntime vmruntime
```
空のオブジェクトを使用して evictionPolicy セクションを追加または更新して、デフォルトのエビクションポリシー設定を使用するか、または必要な設定を追加します。
```
apiVersion: vm.cluster.gke.io/v1
kind: VMRuntime
metadata:
  name: vmruntime
spec:
  disableCDIUploadProxyVIP: false
  enabled: true
  evictionPolicy: {}
  useEmulation: false
```
evictionPolicy が入力されていない場合（evictionPolicy: null など）、またはマニフェストに含まれていない場合、特別なアクションは実行されません。VM は強制的に立ち退かされます。

次のマニフェストの例は、VM のライブマイグレーションを有効にする方法、またはメンテナンスが完了した後に同じホストで VM を再起動する方法を示しています。
ライブマイグレーション
次のエビクションポリシーの例では、VM のライブマイグレーションを有効にします。クラスタはライブマイグレーションを、プロセスを起動するたびに30 秒のタイムアウトで、3 回まで再試行できます。
```
apiVersion: vm.cluster.gke.io/v1
kind: VMRuntime
metadata:
  name: vmruntime
spec:
  disableCDIUploadProxyVIP: false
  enabled: true
  evictionPolicy:
    evictionStrategy: LiveMigrate
    maxMigrationAttemptsPerVM: 3
    migrationTargetInitializationTimeout: 30s
  useEmulation: false
```
再起動
次のエビクションポリシーの例では、エビクションでどの VM に対しても移行が試みられることはありません。VM は現在のホストで停止され、ホストのメンテナンスイベントが終了すると再起動されます。
```
apiVersion: vm.cluster.gke.io/v1
kind: VMRuntime
metadata:
  name: vmruntime
spec:
  disableCDIUploadProxyVIP: false
  enabled: true
  evictionPolicy:
    evictionStrategy: Restart
  useEmulation: false
```
エディタで、VMRuntime カスタムリソースを保存して閉じます。

Google Distributed Cloud 上の VM ランタイムは、クラスタ内の VM にエビクションポリシーを適用します。

次のステップ

Google Distributed Cloud 上の VM ランタイムを使用する VM をスケジュールする

GKE on Bare Metal で VM のエビクション ポリシーを構成する

準備

エビクション ポリシーの設定

evictionStrategy

maxMigrationAttemptsPerVM

migrationTargetInitializationTimeout

エビクション ポリシーを有効にして構成する

ライブ マイグレーション

再起動