概述
集群升级失败最常见的原因是仍在请求已被移除的 API。先扫描目标版本移除或弃用的 API 并完成迁移、让控制面先行、分批排空并升级节点且核对重新调度、全程保持在受支持偏差内，可避免工作负载在升级中异常。
关键步骤
- 扫描目标版本移除或弃用的 API 使用。
- 先升级控制面并确认 API 服务健康。
- 分批排空并升级节点，核对重新调度。
- 保持受支持版本偏差直到收敛。
验证
- 审计日志无已弃用 API 请求。
- 所有节点报告目标版本。
- 工作负载健康。
- 临时版本固定已移除。
决策点
应逐个小版本升级，跳版本会跨越移除的 API 与偏差限制；关键集群宜用蓝绿节点池。
适用范围
本条目围绕「Kubernetes 版本升级工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。
建议在正式环境落地前先在预发或隔离环境演练一遍，把关键观测指标与负责人一并记录，确保出现异常时能快速定位并恢复。
pluto detect-all-in-cluster
# migrate removed APIs, then
kubeadm upgrade apply v1.31.0
kubectl drain node-1 --ignore-daemonsets --delete-emptydir-data