升级集群

本页概述升级 Kubernetes 集群的步骤。

Kubernetes 项目建议及时升级到最新的补丁版本，并确保使用受支持的 Kubernetes 版本。遵循这一建议有助于保障安全。

升级集群的方式取决于你最初部署它的方式、以及后续更改它的方式。

从高层规划的角度看，要执行的步骤是：

准备开始

你必须有一个集群。本页内容涉及从 Kubernetes 1.31 升级到 Kubernetes 1.32。如果你的集群未运行 Kubernetes 1.31，那请参考目标 Kubernetes 版本的文档。

如果你的集群是使用 kubeadm 安装工具部署而来，那么升级集群的详细信息，请参阅升级 kubeadm 集群。

升级集群之后，要记得安装最新版本的 kubectl。

这些步骤不考虑网络和存储插件等第三方扩展。

你应该按照下面的操作顺序，手动更新控制平面：

对于集群中的每个节点，首先需要腾空节点，然后使用一个运行了 kubelet 1.32 版本的新节点替换它；或者升级此节点的 kubelet，并使节点恢复服务。

在升级 kubelet 之前先进行节点排空，这样可以确保 Pod 被重新准入并且容器被重新创建。这一步骤对于解决某些安全问题或其他关键错误是非常必要的。

参阅你的集群部署工具对应的文档，了解用于维护的推荐设置步骤。

对象序列化到 etcd，是为了提供集群中活动 Kubernetes 资源的内部表示法，这些对象都使用特定版本的 API 编写。

当底层的 API 更改时，这些对象可能需要用新 API 重写。如果不能做到这一点，会导致再也不能用 Kubernetes API 服务器解码、使用该对象。

对于每个受影响的对象，请使用最新支持的 API 读取它，然后使用所支持的最新 API 将其写回。

升级到新版本 Kubernetes 就可以获取到新的 API。

你可以使用 kubectl convert 命令在不同 API 版本之间转换清单。例如：

kubectl convert -f pod.yaml --output-version v1

kubectl 替换了 pod.yaml 的内容，在新的清单文件中，kind 被设置为 Pod（未变），但 apiVersion 则被修订了。

如果你的集群正在运行设备插件（Device Plugin）并且节点需要升级到具有更新的设备插件（Device Plugin） API 版本的 Kubernetes 版本，则必须在升级节点之前升级设备插件以同时支持这两个插件 API 版本，以确保升级过程中设备分配能够继续成功完成。