#升级前准备

#升级前的重要注意事项

• 支持升级的平台版本：3.16.0、3.16.1、3.16.2、3.18.0、3.18.1、3.18.2、4.0.0、4.0.1。
  请确保当前平台版本在此支持范围内后再进行升级。

• 平台中所有集群的 Kubernetes 版本 必须 至少为 1.28。
  若有集群版本低于此要求，请先升级该集群的 Kubernetes 版本。

• 若平台中存在由平台提供的 service mesh 集群，确保其 Istio 版本不低于 1.20。否则请先升级 service mesh。

• 检查平台中是否有集群安装了 CostManager 或 Kubecost 插件。
  这些插件在版本 4.0 中已被废弃，升级前必须卸载。

• 若平台版本为 3.16，且任一集群安装了 ClickHouse 日志存储插件，请在升级前卸载该插件。升级完成后再重新安装。

• 确保 global 集群控制平面节点 上的 /cpaas/minio 目录至少有 120 GB 可用空间。
  若空间不足，请先扩容存储。

• 升级过程中，升级包必须复制到 global 集群的任一控制平面节点并解压。
  若升级包和解压路径位于同一磁盘，确保该磁盘至少有 250 GB 空闲空间。

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

• 从版本 4.0 开始，使用 global DR（灾备） 方案的集群升级流程发生变化。
  请参考 global DR procedure 获取新的操作步骤。

#准备操作步骤