ノードの自動修復

このページでは、Google Kubernetes Engine（GKE）クラスタのノードの自動修復について説明します。

概要

ノードの自動修復は、GKE クラスタ内のノードの実行状態を正常に保つための機能です。この機能を有効にすると、GKE でクラスタ内の各ノードのヘルス状態が定期的にチェックされます。ノードが長期にわたって連続してヘルスチェックに失敗すると、GKE はそのノードの修復プロセスを開始します。

Autopilot と Standard の設定

Autopilot クラスタは常にノードを自動的に修復します。この設定を無効にはできません。

Standard クラスタでは、新しいノードプールに対してノードの自動修復がデフォルトで有効になっています。既存のノードプールの自動修復を無効にすることができますが、デフォルトの構成のままにすることをおすすめします。

修復基準

GKE はノードのヘルス ステータスを使用して、ノードを修復する必要があるかどうかを判別します。Ready ステータスを報告しているノードは、正常と見なされます。しきい値として指定された時間の間、ノードが連続して異常ステータスを報告すると、GKE は修復アクションをトリガーします。 異常ステータスとは、次のような状況を意味します。

  • しきい値として指定された時間の間（約 10 分間）、ノードが連続して NotReady ステータスを報告する。
  • しきい値として指定された時間の間（約 10 分間）、ノードがステータスを何も報告しない。
  • ノードのブートディスクが長期間（約 30 分間）にわたり容量不足になっている。

ノードのヘルスシグナルは、kubectl get nodes コマンドを使用していつでも手動で確認できます。

ノードの修復プロセス

修復を必要とするノードが GKE によって検出されると、そのノードはドレインされ、再作成されます。GKE はドレインが完了するまで 1 時間待ちます。ドレインが完了しない場合、ノードはシャットダウンされ、新しいノードが作成されます。

複数のノードで修復が必要な場合、GKE はそれらのノードを並行して修復することもできます。GKE は、クラスタのサイズと障害が発生したノードの数に応じて修復の数を調整します。大規模なクラスタの場合、GKE はより多くのノードを並列して修復しますが、異常なノードの数が増えると並列で修復するノードの数が少なくなります。

修復プロセスの最中にノードの自動修復を無効にした場合、処理中の修復はキャンセルされず、その時点で修復の対象になっているすべてのノードの修復が行われます。

ノード修復履歴

GKE は、自動修復イベントのログエントリを生成します。ログを確認するには、次のコマンドを実行します。

gcloud container operations list

既存の Standard ノードプールの自動修復を有効にする

ノードプール単位でノードの自動修復を有効にします。

標準クラスタの既存のノードプールで自動修復が無効になっている場合、有効にするには次の手順を行います。

gcloud

gcloud container node-pools update POOL_NAME \
    --cluster CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --enable-autorepair

次のように置き換えます。

  • POOL_NAME: ノードプールの名前。
  • CLUSTER_NAME: Standard クラスタの名前。
  • COMPUTE_REGION: クラスタの Compute Engine のリージョン。ゾーンクラスタの場合は、--zone COMPUTE_ZONE オプションを使用します。

Console

  1. Google Cloud コンソールで [Google Kubernetes Engine] ページに移動します。

    Google Kubernetes Engine に移動

  2. クラスタのリストで、変更するクラスタの名前をクリックします。

  3. [ノード] タブをクリックします。

  4. [ノードプール] で、変更するノードプールの名前をクリックします。

  5. [ノードプールの詳細] ページで、[ 編集] をクリックします。

  6. [管理] で、[自動修復を有効化] チェックボックスをオンにします。

  7. [保存] をクリックします。

Standard ノードプールのノードの自動修復が有効になっていることを確認する

ノードの自動修復はノードプール単位で有効になります。クラスタ内のノードプールで Google Cloud CLI または Google Cloud Console の自動修復が有効になっているかどうかを確認できます。

gcloud

ノードプールの説明を表示します。

gcloud container node-pools describe NODE_POOL_NAME \
--cluster=CLUSTER_NAME

ノードの自動修復が有効になっている場合、コマンドの出力には次の行が含まれます。

management:
  ...
  autoRepair: true

Console

  1. Google Cloud コンソールで [Google Kubernetes Engine] ページに移動します。

    Google Kubernetes Engine に移動

  2. Google Kubernetes Engine ページで、検査するノードプールのクラスタの名前をクリックします。

  3. [ノード] タブをクリックします。

  4. [ノードプール] で、検査するノードプールの名前をクリックします。

  5. [管理] の [自動修復] フィールドで、自動修復が有効になっていることを確認します。

ノードの自動修復を無効にする

Standard クラスタで既存のノードプールのノードの自動修復を無効にするには、gcloud CLI または Google Cloud Console を使用します。

gcloud

gcloud container node-pools update POOL_NAME \
    --cluster CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --no-enable-autorepair

次のように置き換えます。

  • POOL_NAME: ノードプールの名前。
  • CLUSTER_NAME: Standard クラスタの名前。
  • COMPUTE_REGION: クラスタの Compute Engine のリージョン。ゾーンクラスタの場合は、--zone COMPUTE_ZONE オプションを使用します。

Console

  1. Google Cloud コンソールで [Google Kubernetes Engine] ページに移動します。

    Google Kubernetes Engine に移動

  2. クラスタのリストで、変更するクラスタの名前をクリックします。

  3. [ノード] タブをクリックします。

  4. [ノードプール] で、変更するノードプールの名前をクリックします。

  5. [ノードプールの詳細] ページで、[ 編集] をクリックします。

  6. [管理] で、[自動修復を有効化] チェックボックスをオフにします。

  7. [保存] をクリックします。

次のステップ