首页/云/Kubernetes 速查/集群升级的顺序与约束
集群运维与排障54 条

集群升级的顺序与约束

升级先控制面后节点,跨版本逐个小版本推进;kubelet 不得比 apiserver 新且只能落后有限个小版本(以官方版本偏差策略为准)。

Kubernetes 速查云更新于 2026-10-12

典型路径(kubeadm 环境示意)

典型路径(kubeadm 环境示意)
kubeadm upgrade plan
# 控制面节点:升级 kubeadm → apply → kubelet/kubectl
kubectl drain node1 --ignore-daemonsets --delete-emptydir-data
# 节点:升级 kubelet 后重启
kubectl uncordon node1
kubectl get nodes -o wide
升级前检查:废弃 API 使用情况、PDB 冗余、etcd 备份、组件兼容矩阵。

易错点

  • 跨多个小版本一次跳:偏差策略不允许,组件兼容风险大
  • 升级前不跑废弃 API 审计:控制面升级后老清单 apply 失败

数据来源与参考

  • Kubernetes 官方文档 · 版本偏差策略与集群升级
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌