本页概述升级 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。离线整理了版式、链接和媒体显示。
