我該如何升級 Amazon EKS 叢集與附加元件?
我想遵循最佳實務來升級我的 Amazon Elastic Kubernetes Service (EKS) 叢集與附加元件。
簡短說明
在升級叢集前,請先確認與新版 Kubernetes 的相容性。此外,您可能需要更新儲存驅動程式與附加元件,才能與較新版本相容。
在您於 Amazon EKS 叢集上升級 Kubernetes 版本後,無法降級回先前版本。在升級 Kubernetes 版本前,請參閱了解 EKS 上的 Kubernetes 版本生命週期。請確認您的安全群組規則允許您在建立叢集時,所指定子網路所需的叢集通訊。
注意:
- 節點的 kubelet 版本不得高於 Kubernetes 版本。
- 當您更新控制平面時,節點群組不會自動升級。
- 節點的 kubelet 版本不得比 Kubernetes 版本低超過兩個次要版本。例如,若 Kubernetes 版本為 1.33,則支援的 kubelet 版本為 1.33、1.32 與 1.31。
次要版本在發佈後,可於 Amazon EKS 中獲得 14 個月的標準支援。之後,該版本會進入 12 個月的延伸支援。
您可以使用延伸支援來更長時間維持特定 Kubernetes 版本,但每個叢集小時會產生額外費用。如果您在延伸支援期間結束前未升級叢集,AWS 會自動將您的叢集升級至目前最早支援的版本。
延伸支援預設為啟用狀態。若要停用延伸支援,請參閱停用 EKS 延伸支援以避免增加叢集成本。如需發佈與支援日期,請參閱 Amazon EKS Kubernetes 發佈行事曆。
解決方法
更新 Amazon EKS 叢集版本
**注意:**如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息,請參閱對 AWS CLI 錯誤進行疑難排解。此外,請確定您使用的是最新的 AWS CLI 版本。
首先,請檢查叢集控制平面與節點目前的 Kubernetes 版本,以及您目前的 eksctl 版本。
請執行以下命令,檢查叢集控制平面的 Kubernetes 版本:
kubectl version
輸出範例:
Client Version: v1.33.2 Kustomize Version: v5.6.0 Server Version: v1.32.5-eks-5d4a308
請執行以下命令,取得節點的 Kubernetes 版本:
kubectl get nodes
輸出範例:
NAME STATUS ROLES AGE VERSION ip-10-42-177-172.ec2.internal Ready <none> 132m v1.32.3-eks-473151a ip-10-42-177-39.ec2.internal Ready <none> 142m v1.32.3-eks-473151a
請執行以下命令,檢查您的 eksctl 版本:
eksctl version
**注意:**您必須使用 eksctl 版本 0.210.0 或更新版本。升級作業需要數分鐘才能完成。
接著,請使用 eksctl、Amazon EKS 主控台或 AWS CLI 其中之一來更新您的叢集。
更新節點群組版本
若要更新受管節點群組,請參閱為您的叢集更新受管節點群組。若要更新自管節點群組,您必須將應用程式遷移至新的節點群組。
更新 Amazon EKS 附加元件
Amazon EKS 不會在控制平面升級期間自動升級附加元件。請檢查附加元件的相容版本,然後進行更新。您一次只能升級一個次要版本。
若要驗證附加元件版本是否與最新的 Kubernetes 版本相容,請執行以下命令:
eksctl utils describe-addon-versions —kubernetes-version 1.33 —name name-of-addon | grep AddonVersion
**注意:**請將 name-of-addon 替換為您的附加元件名稱,並將 1.33 替換為最新的 Kubernetes 版本。
請確認目前版本顯示於輸出中。
輸出範例:
"AddonVersions": [ "AddonVersion": "v1.12.1-eksbuild.2", "AddonVersion": "v1.11.4-eksbuild.14", "AddonVersion": "v1.11.4-eksbuild.10", "AddonVersion": "v1.11.4-eksbuild.2", "AddonVersion": "v1.11.3-eksbuild.3", "AddonVersion": "v1.11.3-eksbuild.2",
您可能需要更新以下 Amazon EKS 附加元件:
- Amazon Virtual Private Cloud Container Network Interface (Amazon VPC CNI),用於 Pod 網路
- CoreDNS,用於 DNS 解析
- kube-proxy,用於路由您的網路
- Amazon Elastic Block Store (Amazon EBS) 與 Amazon Elastic File System (Amazon EFS) Container Storage Interface (CSI) 驅動程式,用於永續性儲存
如需詳細資訊,請參閱 AWS 附加元件。
Amazon VPC CNI 外掛程式
請檢查叢集可相容的 Amazon VPC CNI 版本。
接著,請選擇以下其中一個選項來更新附加元件:
- 若要從自管附加元件遷移到 Amazon EKS 受管附加元件,請參閱建立 Amazon VPC CNI 外掛程式 (Amazon EKS 附加元件)。
- 如果您已有 Amazon EKS 受管附加元件,請參閱更新 Amazon VPC CNI 外掛程式 (Amazon EKS 附加元件)。
- 若要更新自管附加元件,請參閱更新 Amazon VPC CNI (自管附加元件)。
- 若要為服務帳戶設定 AWS Identity and Access Management 角色 (IRSA),請參閱設定 Amazon VPC CNI 外掛程式以使用 IRSA。
kube-proxy
請檢查叢集可相容的 kube-proxy 版本。
接著,請選擇以下其中一個選項來更新附加元件:
- 如果您使用 Amazon EKS 受管附加元件,請參閱更新 Amazon EKS 附加元件。
- 如果您使用自管附加元件,請參閱更新 Kubernetes kube-proxy 自管附加元件。
CoreDNS
請檢查叢集可相容的 CoreDNS 版本。
接著,請選擇以下其中一個選項來更新附加元件:
- 若要從自管遷移至 Amazon EKS 受管附加元件,請參閱建立 CoreDNS Amazon EKS 附加元件。
- 如果您使用 Amazon EKS 受管附加元件,請參閱更新 CoreDNS Amazon EKS 附加元件。
- 如果您使用自管附加元件,請參閱更新 CoreDNS 自管附加元件。
Amazon EBS 與 Amazon EFS CSI 驅動程式
若要更新 Amazon EBS CSI 驅動程式或 Amazon EFS CSI 驅動程式,請參閱更新 Amazon EKS 附加元件。
更新 AWS Load Balancer Controller
如需 AWS Load Balancer Controller 與 Kubernetes 版本的相容性資訊,請參閱 GitHub 網站上的支援的 Kubernetes 版本。AWS Load Balancer Controller 2.5.0 或更新版本需要 Kubernetes 1.22 或更新版本。如需詳細資訊,請參閱 GitHub 網站上的 aws-load-balancer-controller 發佈版本。若要安裝 AWS Load Balancer Controller,請參閱安裝控制器。
- 語言
- 中文 (繁體)
