Amazon EKS Auto 模式的考量事項 Summary 步驟 1：準備升級步驟 2：檢閱升級考量事項步驟 3：更新叢集控制平面步驟 4：更新叢集元件降級 Amazon EKS 叢集的 Kubernetes 版本

將現有叢集更新為新的 Kubernetes 版本

Amazon EKS 中提供新的 Kubernetes 版本時，您可以將 Amazon EKS 叢集更新至最新版本。

重要

升級叢集後，就無法降級至先前的版本。更新至新的 Kubernetes 版本之前，建議您檢閱中的資訊了解 EKS 上的 Kubernetes 版本生命週期和本主題中的更新步驟。

新的 Kubernetes 版本有時會加入重大變更。新的 Kubernetes 版本加入了重大變更，因此推薦您在生產叢集執行更新之前，先針對新的 Kubernetes 版本測試您應用程式的行為。若要達成此目標，您可以在移至新的 Kubernetes 版本之前，先建置持續的整合工作流程來測試應用程式行為。

更新程序包括 Amazon EKS 啟動新的 API 伺服器節點，並使用更新的 Kubernetes 版本取代現有的節點。Amazon EKS 會針對這些新節點上的網路流量執行標準基礎設施和整備運作狀態檢查，以確認它們是否如預期般運作。不過，一旦開始叢集升級，您就無法暫停或停止它。如果檢查有失敗，Amazon EKS 會還原基礎設施部署，之前的 Kubernetes 版本仍然保留您的叢集。執行中的應用程式不會受到影響，而且您的叢集永遠不會處於非確定性或無法復原的狀態。Amazon EKS 會定期備份所有受管叢集，並且具備在必要時復原叢集的機制。我們會持續評估並改善 Kubernetes 基礎設施管理程序。

若要更新叢集，Amazon EKS 最多需要五個來自子網的可用 IP 地址，子網是在您建立叢集時指定的。Amazon EKS 會在您指定的任何子網中建立新的叢集彈性網路介面（網路介面）。網路介面可能會在與您現有網路介面所在的子網不同的子網中建立，因此請確認您的安全群組規則針對您建立叢集時指定的任何子網，允許所需的叢集通訊如果您在建立叢集時指定的任何子網路不存在、沒有足夠的可用 IP 地址，或沒有允許必要叢集通訊的安全群組規則，則更新可能會失敗。

為了確保叢集的 API 伺服器端點始終可存取，Amazon EKS 提供高可用性的 Kubernetes 控制平面，並在更新操作期間執行 API 伺服器執行個體的滾動更新。為了考慮變更支援 Kubernetes API 伺服器端點之 API 伺服器執行個體的 IP 地址，您必須確保您的 API 伺服器用戶端有效管理重新連線。最近版本的 kubectl和正式支援的 Kubernetes 用戶端程式庫，以透明的方式執行此重新連線程序。

注意

若要進一步了解叢集更新的內容，請參閱《EKS 最佳實務指南》中的叢集升級最佳實務。此資源可協助您規劃升級，並了解升級叢集的策略。

Amazon EKS Auto 模式的考量事項

Amazon EKS Auto Mode 的運算功能會控制節點的 Kubernetes 版本。升級控制平面之後，EKS Auto 模式會開始逐步更新受管節點。EKS Auto Mode 遵守 Pod 中斷預算。
您不需要手動升級 Amazon EKS Auto Mode 的功能，包括運算自動擴展、區塊儲存和負載平衡功能。

Summary

Amazon EKS 叢集升級程序的高階摘要如下：

確保您的叢集處於支援升級的狀態。這包括檢查部署至叢集的資源所使用的 Kubernetes APIs，確保叢集沒有任何運作狀態問題。評估叢集的升級準備程度時，您應該使用 Amazon EKS 升級洞察。
將控制平面升級至下一個次要版本（例如，從 1.31 升級至 1.32)。
升級資料平面中的節點，以符合控制平面的節點。
升級在叢集上執行的任何其他應用程式（例如 cluster-autoscaler)。
升級 Amazon EKS 提供的附加元件，例如預設包含的附加元件：
升級任何與叢集通訊的用戶端（例如 kubectl)。

步驟 1：準備升級

將叢集控制平面的 Kubernetes 版本與節點的 Kubernetes 版本進行比較。

取得叢集控制平面的 Kubernetes 版本。
```
kubectl version
```
取得節點的 Kubernetes 版本。此命令會傳回所有自我管理和受管 Amazon EC2、Fargate 和混合節點。每個 Fargate Pod 都會列為自己的節點。
```
kubectl get nodes
```

將控制平面更新為新的 Kubernetes 版本之前，請確定叢集中受管節點和 Fargate 節點的 Kubernetes 次要版本與控制平面的版本相同。例如，如果您的控制平面正在執行版本，1.29且其中一個節點正在執行版本 1.28，則您必須先將節點更新為版本，1.29才能將控制平面更新為 1.30。我們也建議您在更新控制平面之前，將自我管理節點和混合節點更新為與控制平面相同的版本。如需詳細資訊，請參閱更新叢集的受管節點群組、更新叢集的自我管理節點及升級叢集的混合節點。如果您有 Fargate 節點的次要版本低於控制平面版本，請先刪除由節點表示的 Pod。接著更新您的控制平面。任何剩餘的 Pod 都會在您重新部署後更新為新版本。

步驟 2：檢閱升級考量事項

Amazon EKS 叢集洞察會根據影響已棄用 Kubernetes API 用量等問題的潛在 Kubernetes 版本升級清單自動掃描叢集。Amazon EKS 會根據 Kubernetes 專案中的變更評估，定期更新要執行的洞見檢查清單。隨著 Amazon EKS 服務以及新版本引入變更，Amazon EKS 也會更新洞見檢查清單。如需詳細資訊，請參閱準備進行 Kubernetes 版本升級，並使用叢集洞察對錯誤設定進行疑難排解。

檢閱 Kubernetes 文件中的已棄用 API 遷移指南。

檢閱叢集洞見

使用 Amazon EKS 叢集洞察來識別問題

開啟 Amazon EKS 主控台。
從叢集清單中，選擇您想要查看其相關洞察之 Amazon EKS 叢集的名稱。
選擇檢視儀表板。
選擇 Cluster Insights 標籤。
在升級洞見表格中，您會看到下列資料欄：
- 名稱：Amazon EKS 對叢集執行的檢查。
- 洞見狀態 – 狀態為「錯誤」的洞見通常表示受影響的 Kubernetes 版本是目前叢集版本的 N+1，而狀態為「警告」表示洞見適用於未來的 Kubernetes 版本 N+2 或更高版本。「通過」狀態意味著 Amazon EKS 在此洞察檢查中未發現叢集中存在任何問題。「不明」狀態意味著 Amazon EKS 無法確定叢集是否受到此洞察檢查的影響。
- 版本 – 洞見檢查是否有可能問題的 Kubernetes 版本。
- 上次重新整理時間 – 此叢集的洞見狀態上次重新整理的時間。
- 上次轉換時間 – 此洞見的狀態上次變更的時間。
- 描述：來自洞察檢查的資訊，其中包括提醒和建議的補救措施。

詳細考量事項

由於 Amazon EKS 執行高可用性的控制平面，因此您一次只能更新一個次要版本。如需此要求的詳細資訊，請參閱 Kubernetes Version and Version Skew Support Policy (Kubernetes 版本和版本差異支援政策)。假設您目前的叢集版本是版本 1.28，並且您想要將其更新為版本 1.30。您必須先將您的版本 1.28 叢集更新為版本 1.29，再將版本 1.29 叢集更新為版本 1.30。
檢閱kubelet節點上 Kubernetes kube-apiserver和之間的版本扭曲。
- 從 Kubernetes 版本開始1.28， kubelet 最多可有三個早於的次要版本kube-apiserver。請參閱 Kubernetes upstream version skew policy 一節。
- 如果受管節點和 Fargate 節點kubelet上的位於 Kubernetes 版本1.25或更新版本上，您可以提前更新叢集最多三個版本，而無需更新kubelet版本。例如，如果 kubelet 的版本是 1.25，在保持 kubelet 的版本為 1.25 的情況下，您可以將您的 Amazon EKS 叢集版本從 1.25 更新為 1.26、1.27 或 1.28
作為開始更新前的最佳實務，請確定節點kubelet上的與控制平面的 Kubernetes 版本相同。
如果您的叢集設定了早於的 Kubernetes 的 Amazon VPC CNI 外掛程式版本1.8.0，建議您在更新叢集之前將外掛程式更新至最新版本。若要更新外掛程式，請參閱使用 Amazon VPC CNI 將 IPs 指派給 Pod。

步驟 3：更新叢集控制平面

重要

Amazon EKS 已暫時復原一項功能，在發生特定叢集洞見問題時，會要求您使用--force旗標來升級叢集。如需詳細資訊，請參閱 GitHub 上對更新叢集版本強制執行升級洞察的暫時復原。

Amazon EKS 會在「上次重新整理時間」的 24 小時後重新整理叢集洞見。您可以比較您解決問題的時間與叢集洞見的「上次重新整理時間」。

此外，在解決取代的 API 用量之後，洞見狀態最多可能需要 30 天才能更新。升級洞見一律會在滾動的 30 天時段內尋找已棄用的 API 用量。

您可以使用下列方式提交升級 EKS 控制平面版本的請求：

eksctl
AWS 主控台
AWS CLI

更新叢集 - eksctl

此程序需要 eksctl 版本 0.210.0 或更新版本。您可使用以下命令檢查您的版本：


eksctl version

如需有關安裝和更新 eksctl 的指示，請參閱 eksctl 文件中的 Installation 一節。

更新 Amazon EKS 控制平面的 Kubernetes 版本。使用您的叢集名稱取代 <cluster-name>。<version-number> 將取代為您要更新叢集的 Amazon EKS 支援版本編號。如需支援的版本編號清單，請參閱了解 EKS 上的 Kubernetes 版本生命週期。


eksctl upgrade cluster --name <cluster-name> --version <version-number> --approve

此更新需要幾分鐘的時間來完成。

繼續進行步驟 4：更新叢集元件。

更新叢集 - AWS 主控台

開啟 Amazon EKS 主控台。
針對您要升級的叢集，選擇立即升級。
選取要將叢集更新為的版本，然後選擇升級。
此更新需要幾分鐘的時間來完成。繼續進行步驟 4：更新叢集元件。

更新叢集 - AWS CLI

確認已安裝 AWS CLI 且您已登入。如需詳細資訊，請參閱安裝或更新至最新版本的 AWS CLI。

使用以下 CLI 命令更新您的 Amazon EKS AWS 叢集。取代您要升級<region-code>之叢集的 <cluster-name>和。<version-number> 將取代為您要更新叢集的 Amazon EKS 支援版本編號。如需支援的版本編號清單，請參閱了解 EKS 上的 Kubernetes 版本生命週期。


aws eks update-cluster-version --name <cluster-name> \
  --kubernetes-version <verion-number> --region <region-code>

範例輸出如下。


{
    "update": {
        "id": "<update-id>",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "<version-number>"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

此更新需要幾分鐘的時間來完成。使用下列命令來監控叢集更新的狀態。除了使用相同的 <cluster-name>和之外<region-code>，請使用上一個命令傳回<update-id>的。
```
aws eks describe-update --name <cluster-name> \
   --region <region-code> --update-id <update-id>
```
顯示 Successful 狀態時，即表示更新已完成。
繼續進行步驟 4：更新叢集元件。

步驟 4：更新叢集元件

叢集更新完成之後，請將您的節點更新至與已更新叢集相同的 Kubernetes 最低版本。如需詳細資訊，請參閱更新叢集的自我管理節點、更新叢集的受管節點群組及升級叢集的混合節點。在 Fargate 上啟動的任何新 Pod 都有符合您叢集kubelet版本的版本。現有的 Fargate Pod 不會變更。
(選用) 如果您在更新叢集之前已將 Kubernetes Cluster Autoscaler 部署至叢集，則請將 Cluster Autoscaler 更新為符合您最後更新之 Kubernetes 主要和次要版本的最新版本。
1. 在 Web 瀏覽器中開啟 Cluster Autoscaler 版本頁面，並尋找符合您叢集 Kubernetes 主要和次要版本的最新 Cluster Autoscaler 版本。例如，如果您叢集的 Kubernetes 版本1.30找到開頭為的最新 Cluster Autoscaler 版本1.30。記錄該版本的語意版本編號 (例如，1.30.n)，以在下一步中使用。
2. 使用下列命令，將 Cluster Autoscaler 映像標籤設定為您在前一個步驟中記錄的版本。如有必要，請使用您自己的值取代 X.XX.X。
```
kubectl -n kube-system set image deployment.apps/cluster-autoscaler cluster-autoscaler=registry.k8s.io/autoscaling/cluster-autoscaler:vX.XX.X
```
（僅限具有 GPU 節點的叢集）如果您的叢集具有具有 GPU 支援的節點群組（例如 p3.2xlarge)，您必須在叢集上更新適用於 KubernetesDaemonSet 的 NVIDIA 裝置外掛程式。 DaemonSet 請先以您想要的 NVIDIA/k8s-device-plugin 版本來取代 <vX.X.X>，再執行下列命令。
```
kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/<vX.X.X>/deployments/static/nvidia-device-plugin.yml
```
更新 Kubernetes、CoreDNS 和kube-proxy附加元件的 Amazon VPC CNI 外掛程式。建議您將附加元件更新為服務帳戶字符中列出的最低版本。
- 如果您正在使用 Amazon EKS 附加元件，請在 Amazon EKS 主控台中選取 Clusters (叢集)，然後在左導覽窗格中選取您已更新的叢集名稱。通知會顯示在主控台。它們會通知您每個有可用更新的附加元件有新的可用版本。若要更新附加元件，請選擇 Add-ons (附加元件) 標籤。在具有可用更新之附加元件的其中一個方塊中，選取 Update now (立即更新)，選取可用的版本，然後選取 Update (更新)。
- 或者，您可以使用 AWS CLI 或 eksctl 來更新附加元件。如需詳細資訊，請參閱更新 Amazon EKS 附加元件。
如有必要，請更新您的 kubectl 版本。您所使用的 kubectl 版本，必須與 Amazon EKS 叢集控制平面的版本差距在一個版本以內。

降級 Amazon EKS 叢集的 Kubernetes 版本

您無法降級 Amazon EKS 叢集的 Kubernetes。相反地，請在先前的 Amazon EKS 版本上建立新的叢集，並遷移工作負載。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

檢視叢集洞見

刪除叢集