将现有集群更新到新的 Kubernetes 版本

比较集群控制层面的 Kubernetes 版本与节点的 Kubernetes 版本。

将控制面板升级到新的 Kubernetes 版本之前，确保集群中的托管节点和 Fargate 节点的 Kubernetes 次要版本与控制面板的版本相同。例如，如果您的控制面板正在运行 1.29 版本，且其中一个节点正在运行 1.28 版本，则您必须将节点更新为 1.29 版本，然后将控制面板更新为 1.30。我们还建议在更新控制面板之前，将自主管理型节点和混合节点更新到与控制面板相同的版本。有关更多信息，请参阅更新集群的托管式节点组、更新集群的自行管理型节点和升级集群的混合节点。如果 Fargate 节点的次要版本低于控制面板版本，请先删除节点所表示的容器组（pod）。然后更新您的控制面板。剩余的容器组（pod）将在重新部署之后更新到新版本。

如果您最初部署集群所用的 Kubernetes 版本是 Kubernetes 1.25 或更高版本，请跳过此步骤。

Amazon EKS 集群上默认已启用容器组（pod）安全策略准入控制器。在升级集群前，请确保已实施适当的容器组（pod）安全策略。这是为了避免潜在的安全问题。您可以使用 kubectl get psp eks.privileged 命令检查默认策略。

kubectl get psp eks.privileged

如果您收到以下错误，请参阅Amazon EKS 默认容器组（pod）安全策略，然后再继续操作。

Error from server (NotFound): podsecuritypolicies.extensions "eks.privileged" not found

如果您最初部署集群所用的 Kubernetes 版本是 Kubernetes 1.18 或更高版本，请跳过此步骤。

您可能需要从自己的 CoreDNS 清单中删除已停用的术语。

打开 Amazon EKS 控制台。

选择要更新的 Amazon EKS 集群的名称，然后选择 Update cluster version (更新集群版本)。

对于 Kubernetes version (Kubernetes 版本)，选择您的集群要更新到的版本并选择 Update (更新)。

对于 Cluster name（集群名称），输入您的集群的名称并选择 Confirm（确认）。

更新过程可能需要几分钟才能完成。

继续步骤 4：更新集群组件

使用以下 Amazon CLI 命令更新 Amazon EKS 集群。将 example values 替换为您自己的值。将 1.30 替换为您想要将集群更新到的 Amazon EKS 支持的版本号。有关支持的版本号列表，请参阅 了解 EKS 上的 Kubernetes 版本生命周期。

aws eks update-cluster-version --region region-code --name my-cluster --kubernetes-version 1.30

示例输出如下。

{
    "update": {
        "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

使用以下命令监控集群更新的状态。使用上一命令返回的集群名称和更新 ID。当 Successful 状态显示时，更新完成。更新过程可能需要几分钟才能完成。

aws eks describe-update --region region-code --name my-cluster --update-id b5f0ba18-9a87-4450-b5a0-825e6e84496f

示例输出如下。

{
    "update": {
        "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
        "status": "Successful",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

继续步骤 4：更新集群组件

集群更新完成后，将节点更新为与已更新的集群相同的 Kubernetes 版本。有关更多信息，请参阅更新集群的自行管理型节点、更新集群的托管式节点组和升级集群的混合节点。在 Fargate 上启动的任何新容器组（pod）都具有与您的集群版本匹配的 kubelet 版本。现有 Fargate Pod 不会更改。

（可选）如果您在更新集群之前将 Kubernetes Cluster Autoscaler 部署到了集群，请将 Cluster Autoscaler 更新为与您升级后的 Kubernetes 主版本和次要版本匹配的最新版本。

（仅限具有 GPU 节点的集群）如果您的集群具有支持 GPU 的节点组（例如 p3.2xlarge），则您必须在集群上更新适用于 Kubernetes 的 NVIDIA 设备插件 DaemonSet。将 vX.X.X 替换为您需要的 NVIDIA/k8s-device-plugin 版本，然后运行以下命令。

kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/vX.X.X/deployments/static/nvidia-device-plugin.yml

更新适用于 Kubernetes 的 Amazon VPC CNI 插件、CoreDNS 和 kube-proxy 附加组件。建议将附件组件更新为服务账户令牌中列出的最低版本。

如有必要，请更新您的 kubectl 版本。您必须使用与 Amazon EKS 集群控制面板不同的次要版本内的 kubectl 版本。