このページの改善にご協力ください

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「GitHub でこのページを編集する」リンクを選択してください。

EKS Auto Mode クラスターをロールバックする

EKS Auto Mode を実行しているクラスター上でバージョンロールバックを開始すると、Amazon EKS はコントロールプレーンを元に戻す前に Auto Mode ワーカーノードのロールバックを自動的に管理します。このページでは、Auto Mode ノードのロールバックの仕組み、それを高速化する方法、および必要に応じてキャンセルする方法について説明します。

前提条件、インサイトチェック、ロールバックプロセス全体など、バージョンロールバックに関する一般的な情報については、「以前の Kubernetes バージョンにクラスターをロールバックする」を参照してください。

Auto Mode のロールバックの仕組み

EKS Auto Mode は Karpenter ベースのシステムを使用して、Kubernetes バージョンのアップグレードやロールバックなどのワーカーノードインフラストラクチャを管理します。Auto Mode が有効になっているクラスター上で以前の (N-1) バージョンで UpdateClusterVersion を呼び出すと、EKS は次のシーケンスを実行します:

コントロールプレーンは現在の (新しい) バージョンのままで、ノードがロールバックしている間もトラフィックを正常に処理し続けます。Kubernetes バージョンスキューポリシーでは、kube-apiserver より古い最大 3 つのマイナーバージョンをノードで実行できるため、この中間状態は有効です。

ロールバック中のクラスターステータス

クラスターのステータスは、ノードのロールバックフェーズ中も ACTIVE のままです。ListUpdates または DescribeUpdate を使用して、ロールバックが進行中かどうかを判断します。Amazon EKS コンソールで、クラスターに移動し、更新履歴タブを開いて、ロールバックに関連付けられた更新 ID のステータスを表示します。

ロールバック中に個々のノードの進行状況を追跡するには、Auto Mode ノードの Kubernetes バージョンを確認します。

kubectl get nodes -l karpenter.sh/nodepool=<nodepool-name> -o wide

中断コントロール

Auto Mode のロールバックは、既存のすべての中断コントロールを尊重します。これらのコントロールは、ノードを置き換える速さを決定し、ロールバック期間に大きな影響を与える可能性があります。

NodePool 中断予算

NodePool 中断予算は、同時に中断できるノードの数を制御します。ロールバック中、Karpenter はノードを以前のバージョンにドリフトするときにこれらの予算を尊重します。

ノードの 10% を一度に置き換えることができる中断予算を持つ NodePool の例:

apiVersion: karpenter.sh/v1
kind: NodePool
metadata:
  name: default
spec:
  disruption:
    budgets:
      - nodes: "10%"
        reasons:
          - Drifted

NodePool 中断予算の設定の詳細については、「EKS Auto Mode 用のノードプールを作成する」および「Karpenter 中断予算」を参照してください。

PodDisruptionBudgets

Kubernetes PodDisruptionBudgets はノードの交換時に優先されます。PDB がポッドのエビクションを妨げる場合、ノードの中断は最大 TerminationGracePeriod 遅延します。

詳細については、「PDB を使用して重要なワークロードを保護する」および「Kubernetes の PDB ドキュメント」を参照してください。

Do-not-disrupt 注釈

karpenter.sh/do-not-disrupt 注釈はノードまたはポッド上で設定できます。

ノード上: ノードの中断を無期限にブロックします。これにより ERROR インサイトがトリガーされ、そのノード上でロールバックを続行する前に削除する必要があります。

ポッド上: 最大 TerminationGracePeriod ノードの中断を遅延します。これにより WARNING インサイトがトリガーされますが、ロールバックは完全にブロックされません。

Karpenter の中断動作の詳細については、「Karpenter の中断ドキュメント」を参照してください。

ロールバックの高速化

ロールバックに予想以上に時間がかかる場合は、ロールバックの進行中に中断コントロールを調整できます。

NodePool 中断予算を増やす

NodePool リソースを編集して、より多くの同時ノード置換を許可します。

kubectl edit nodepool default

予算をより高い値に変更します:

spec:
  disruption:
    budgets:
      - nodes: "50%"
        reasons:
          - Drifted

ノードから do-not-disrupt 注釈を削除する

注釈を使用してノードを一覧表示し、それを削除します。

# List nodes with the annotation
kubectl get nodes -o json | jq '.items[] | select(.metadata.annotations["karpenter.sh/do-not-disrupt"] == "true") | .metadata.name'

# Remove from a specific node
kubectl annotate node <node-name> karpenter.sh/do-not-disrupt-

PodDisruptionBudgets を調整する

PDB がポッドの削除を遅くしている場合は、一時的にそれらを調整します:

kubectl edit pdb <pdb-name> -n <namespace>

中断コントロールの管理の詳細については、「Amazon EKS Auto Mode でのポッドとノードの中断の防止」を参照してください。

ロールバックのキャンセル

ロールバックは、ノードがロールバックしている間のみ、キャンセル可能な状態になります。このフェーズで CancelUpdate を使用してオペレーションを停止できます。

aws eks cancel-update \
  --name my-cluster \
  --update-id <update-id> \
  --region us-west-2

キャンセル動作

キャンセル後

キャンセルが成功すると、ノードは通常どおり現在のクラスターバージョンにドリフトします。更新は Cancelling から Cancelled に移行します。

キャンセル後、すぐに以下を行えます:

キャンセルできない場合

ノードのロールバックが既に完了していてコントロールプレーンのロールバックが開始されている場合、または更新が Successful または Failed ステータスで既に完了している場合、キャンセルは失敗します。

ロールバックのタイムアウト

Auto Mode ノードのロールバックには、rollbackConfig の timeoutMinutes パラメータによって制御される設定可能なタイムアウトがあります。デフォルトのタイムアウトは 720 分 (12 時間) です。値は 120 分 (2 時間)～10080 分 (7 日) で設定できます。タイムアウトは、最小許容プロパティです。つまり、指定した時間よりも早く発生することはありませんが、その後すぐに発生する可能性があります。

aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --rollback-config timeoutMinutes=1440 \
  --region us-west-2

すべてのノードが指定されたタイムアウト内にロールバックを完了していない場合:

タイムアウト後、元のアップグレードから 7 日間のロールバック資格ウィンドウ内にある場合は、ロールバックを再試行できます。実際には、ノードのロールバックが 7 日目にタイムアウトする場合、ロールバック資格ウィンドウも 7 日間であるため、それが期限切れになっている可能性があります。

タイムアウトを回避するには、ロールバックを開始する前にロールバックの準備状況インサイトを確認してください。これらのインサイトは、ノードのロールバックプロセスを遅らせる可能性のある中断予算や注釈について警告します。

--force フラグと Auto Mode

UpdateClusterVersion 上の --force フラグは、クラスターインサイトチェックのみをバイパスします。Auto Mode ノードの中断動作には影響しません。

--force を使用しても、次のようになります:

ノードのロールバックを高速化する唯一の方法は、中断コントロール自体を調整することです。詳細については、「ロールバックの高速化」を参照してください。

IaC タイムアウトの競合

Infrastructure-as-Code ツールには、Auto Mode のロールバック期間と競合する可能性のあるタイムアウト制限があります。CloudFormation では、リソースごとに最大 36 時間許可されます。オペレーションがタイムアウトすると、CloudFormation はこれを no-op として扱います。これにより、クラスターがドリフト状態になり、テンプレートに実際のクラスターバージョンが反映されない可能性があります。バージョンロールバックは明示的に開始される必要があります。Terraform Enterprise/Cloud のタイムアウトは約 24 時間ですが、クライアント側のタイムアウトは認証情報の有効期限やその他の要因によって異なる場合があります。

ロールバック期間を IaC ツールに合わせるには、rollbackConfig の timeoutMinutes パラメータを使用して適切なタイムアウトを設定します。IaC ツールがタイムアウトした場合は、CancelUpdate API を直接使用してコントロールを回復します。制限付きの中断予算がある場合は、IaC の代わりに CLI または API から直接ロールバックを開始することを検討してください。

ノードのロールバック中のシステム更新

Auto Mode ノードがロールバックしている間、EKS はコントロールプレーンの安全性と可用性を引き続き維持します。

顧客トリガーの更新 (UpdateClusterVersion や UpdateClusterConfig など) は、ノードのロールバックの進行中にブロックされます。優先度の高い更新を実行する必要がある場合は、まず CancelUpdate を使用してロールバックをキャンセルしてから、更新を実行し、資格ウィンドウ内にある場合はロールバックを再開します。

関連リソース