大网数据广告活动
Kubernetes 部署与运维

升级集群

· 52CE 我爱测

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

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

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

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

从高层规划的角度看,要执行的步骤是:

  • 升级
  • 升级集群中的节点
  • 升级 之类的客户端
  • 根据新 Kubernetes 版本带来的 API 变化,调整清单文件和其他资源

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

在 Linux 节点上,kubelet 默认仅支持 CGroup v2。

对于 Kubernetes ,kubelet 配置选项 FailCgroupV1 默认设置为 true。

要了解更多信息,请参阅 Kubernetes CGroup v1 弃用文档。

升级方法 {#upgrade-approaches}

kubeadm {#upgrade-kubeadm}

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

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

手动部署 {#manual-deployments}

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

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

  • etcd(所有实例)
  • kube-apiserver(所有控制平面的宿主机)
  • kube-controller-manager
  • kube-scheduler
  • cloud controller manager(在你用到时)

现在,你应该安装最新版本的 kubectl。

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

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

其他部署方式 {#upgrade-other}

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

升级后的任务 {#post-upgrade-tasks}

切换集群的存储 API 版本 {#switch-your-clusters-storage-api-version}

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

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

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

更新清单 {#update-manifests}

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

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

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

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

设备插件 {#device-plugins}

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

有关详细信息,请参阅 API 兼容性和 kubelet 设备管理器 API 版本。

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。