協助改進此頁面

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的在 GitHub 上編輯此頁面連結。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將叢集轉返至先前的 Kubernetes 版本

透過 Amazon EKS 版本復原，您可以在執行就地升級後將叢集的 Kubernetes 控制平面還原至先前的次要版本。如果您在升級後遇到問題，例如應用程式不相容、已棄用 API 使用或意外行為，您可以轉返以將叢集還原為已知的良好狀態。

在轉返期間，Amazon EKS 會將 Kubernetes API 伺服器和控制平面元件還原至先前的版本，同時保留所有刻印資料、客戶工作負載和持久性磁碟區。

復原的內容

不會復原的內容

先決條件

在您可以復原叢集之前，必須符合下列所有條件：

除了上述要求之外，某些條件即使有 --force旗標，也無法復原。這些包括：叢集是在目前版本建立的，自升級以來已超過 7 天，叢集已再次升級至較新的版本，或在目前版本界限中啟用回溯不相容的 EKS 功能。

摘要

Amazon EKS 叢集復原程序的高階摘要如下：

步驟 1：檢閱轉返整備洞見

Amazon EKS 會根據一組point-in-time復原準備度檢查自動評估您的叢集，並透過 ROLLBACK_READINESS類別下的叢集洞見顯示任何問題。這些洞見會在您執行升級後顯示，並在 7 天復原資格時段期間保持可用。

檢視回復整備洞察

AWS 主控台：

AWS CLI：

aws eks list-insights \
  --cluster-name my-cluster \
  --region us-west-2 \
  --filter '{"categories": ["ROLLBACK_READINESS"]}'

若要取得特定洞見的詳細資訊：

aws eks describe-insight \
  --cluster-name my-cluster \
  --region us-west-2 \
  --id <insight-id>

重新整理洞見

EKS 每 24 小時重新整理一次洞見。您可以在使用 Amazon EKS 主控台中的重新整理按鈕或使用 CLI 解決問題後手動觸發重新整理：

aws eks start-insights-refresh \
  --cluster-name my-cluster \
  --region us-west-2

Insight 狀態行為

具有 ERROR 或 UNKNOWN 狀態的洞見會封鎖復原。具有 PASSING 或 WARNING 狀態的洞見不會阻止您復原。

轉返準備度檢查

Amazon EKS 會執行一組檢查，做為復原整備洞察的一部分。這些檢查會評估 API 用量相容性 （包括欄位層級變更偵測）、叢集運作狀態、kubelet 版本偏斜、kube-proxy 版本偏斜，以及附加版本相容性。對於執行 EKS Auto Mode 的叢集，其他檢查會評估 NodePool 中斷預算、do-not-disrupt註釋和 PodDisruptionBudget 組態。

使用 --force 旗標

如果復原整備洞察顯示錯誤狀態，而且您想要繼續而不解決問題，您可以使用 --force旗標略過所有洞察檢查：

aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --force \
  --region us-west-2

--force 旗標只會略過洞見檢查。它不會略過先決條件驗證，例如 7 天時段、建立版本檢查或循序轉返檢查。對於自動模式叢集， --force 不會覆寫中斷控制。NodePool 中斷預算、PDBs和do-not-disrupt註釋仍然被接受。

步驟 2：準備工作者節點

在復原控制平面之前，請確定您的工作者節點與目標版本相容。Kubernetes 版本扭曲政策要求工作者節點無法執行比控制平面更新的版本。

EKS 自動模式

不需要採取行動。當您啟動轉返時，EKS 會在控制平面之前自動轉返自動模式節點。如需詳細資訊，請參閱回復 EKS Auto Mode 叢集。

受管節點群組 (MNG)

您必須先將受管節點群組復原至先前的版本，才能復原控制平面。使用 UpdateNodegroupVersion API：

aws eks update-nodegroup-version \
  --cluster-name my-cluster \
  --nodegroup-name my-nodegroup \
  --kubernetes-version 1.30 \
  --region us-west-2

節點群組更新遵守您設定的更新設定 (maxUnavailable 或 maxUnavailablePercentage) 和更新策略 （滾動或強制）。

自我管理節點和混合節點

您負責復原自我管理節點和混合節點。在轉返控制平面之前，更新您的節點 AMIs 或組態以使用先前的 Kubernetes 版本。

Fargate

Fargate 工作者節點不支援版本轉返。您可以復原使用 Fargate 之叢集的控制平面，但執行與控制平面相同 Kubernetes 版本的 Fargate Pod 會觸發具有 ERROR 狀態的 kubelet 版本扭曲洞見。

EKS 無法自動將 Fargate Pod 復原至較舊的 kubelet 版本。

解決方法：如果您的 Fargate Pod 執行與控制平面相同的 Kubernetes 版本，請在啟動復原之前刪除這些 Pod。然後復原您的控制平面。當您重新部署時，任何剩餘的 Pod 都會使用復原版本啟動。

或者，使用 --force 略過洞見檢查。不過，繼續進行 kubelet 版本扭曲違規可能會導致 Fargate 工作負載發生意外行為，直到這些 Pod 被取代為止。

步驟 3：轉返叢集控制平面

您可以使用 AWS 主控台、 AWS CLI 或 EKS API 啟動轉返。

使用 AWS 主控台轉返叢集

復原需要幾分鐘的時間才能完成。對於自動模式叢集，節點復原階段可能需要更長的時間。如需詳細資訊，請參閱回復 EKS Auto Mode 叢集。

使用 CLI AWS 轉返叢集

使用現有update-cluster-version命令搭配先前的 (N-1) Kubernetes 版本：

aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --region us-west-2

回應範例：

{
    "update": {
        "id": "e4091a28-ea14-48fd-a8c7-975aeb469e8a",
        "status": "InProgress",
        "type": "VersionRollback",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.16"
            }
        ],
        "createdAt": "2026-05-12T16:56:01.082000-04:00",
        "errors": []
    }
}

步驟 4：監控轉返進度

您可以使用 Amazon EKS 主控台或 AWS CLI 監控叢集轉返的狀態。

AWS CLI：

aws eks describe-update \
  --name my-cluster \
  --region us-west-2 \
  --update-id e4091a28-ea14-48fd-a8c7-975aeb469e8a

AWS 主控台：

狀態轉換

對於標準叢集 （無自動模式）：

InProgress → Successful
InProgress → Failed

對於自動模式叢集，叢集狀態會在節點復原ACTIVE時保持，並且UPDATING只有在控制平面復原開始時才會變更為 。使用 describe-update 追蹤整體轉返進度。如需詳細資訊，請參閱回復 EKS Auto Mode 叢集。

顯示Successful狀態時，復原即完成。

考量事項和警告

洞見是最佳努力和point-in-time

叢集洞察會在觸發轉返時進行評估。如果您在檢查洞見之後但在復原完成之前對叢集進行變更 （例如，使用新 APIs建立資源），這些變更不會由初始洞見檢查擷取，而且可能會在復原完成之後造成問題。

等式資料保留

EKS 會在轉返期間保留已刪除的資料。使用 --force旗標略過的不相容資源會保留，不會收集垃圾。

延長支援費用

如果您從標準支援下的版本轉返至延伸支援下的版本，您的叢集會開始產生延伸支援費用。例如，如果您從 1.30 （延伸支援） 升級至 1.31 （標準支援），然後復原至 1.30，則延伸支援費用會繼續。

復原的共同責任模型

EKS 會將 Kubernetes 控制平面復原至所需的版本。作為共同責任模型的一部分，您有責任驗證應用程式與先前版本的相容性：

CloudFormation 堆疊復原行為

如果 CloudFormation 堆疊更新失敗並觸發堆疊復原，則還原至指定較低 Kubernetes 版本的先前範本版本不會觸發叢集版本復原。必須透過 UpdateClusterVersion API、CLI 或主控台明確啟動版本轉返。

轉返和附加元件

在叢集版本復原期間，EKS 不會自動復原附加元件版本。您必須分別管理附加元件版本。

在轉返控制平面之前：

aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name vpc-cni \
  --addon-version v1.12.0-eksbuild.2 \
  --region us-west-2

+ 。 控制平面復原完成後，請確認所有附加元件都正常運作。

相關資源