#升级前准备

支持的升级路径：3.16 → 4.0、3.18 → 4.0。
升级前，请确保当前平台版本处于此支持范围内。

#升级前重要注意事项

• 从 4.0 开始，除默认的 ETCD 备份任务外，所有周期性 ETCD 备份任务将被废弃。升级前，请备份并删除除任务 etcd-backup-default 以外的所有 ETCD 备份任务（删除周期性备份任务不会移除任何已有的 ETCD 快照，仅删除任务本身）。升级完成后，您可以根据需要重新配置 etcd-backup-default 任务。

• 当升级集群的 Kubernetes 版本至 1.31 或更高 时，所有运行中的 Pod 将被 重启。此行为是由于 Kubernetes 1.31 引入的 PodSpec 字段变更导致，无法避免。详情请参阅 Kubernetes 问题报告：#129385。

• 从 4.0 开始，DR（灾备环境） 的升级流程已发生变化。请参阅 global DR procedure 了解新流程。

#前提条件

条件	要求	不满足时
Service mesh (Istio)	所有集群运行版本需为 1.20 或更高	在升级 Kubernetes 或 之前先升级 Istio 及其实例
Kubernetes	所有集群运行版本需为 1.28 或更高	在升级 之前先升级 Kubernetes；注意需先升级 Istio
CostManager / Kubecost 插件	必须 未安装（4.0 版本废弃）	卸载这些插件
Elasticsearch 日志	必须符合 How to Correct the Issue of Node Role Settings in Big Cluster Elasticsearch 中描述的修复（见自定义门户 > 知识库）	升级前应用该修复
/cpaas/minio 磁盘空间（global 集群控制平面）	至少有 120 GB 可用空间	扩容存储
升级包解压磁盘空间	如果安装包和解压路径在同一磁盘，至少有 250 GB 可用空间	释放或扩容存储

#准备操作步骤