#升级前准备

从 3.x 到 4.x 的 升级过程与 4.x 系列内 的升级过程有显著差异。以下章节分别描述这两种升级路径：

• 从 4.x 升级
• 从 3.x 升级

支持的升级路径：

• 从 4.0 → 4.1
• 从 3.18 → 4.1
• 从 3.18 → 4.0
• 从 3.16 → 4.0

开始之前，请确保您当前的平台版本处于支持的升级范围内。

#重要说明

从 4.0 开始：

• 灾难恢复（DR）环境的升级操作步骤已更改。详情请参见Global DR Procedure。

• 所有自定义的周期性 ETCD 备份任务将被废弃。升级前请执行：

  • 备份并删除除 etcd-backup-default 以外的所有 ETCD 备份任务。
  • 删除备份任务不会移除任何已存在的 ETCD 快照，仅删除任务本身。
  • 升级后，您可以根据需要重新配置 etcd-backup-default 任务。

• CostManager 和 Kubecost 已废弃。如已安装，必须在升级前卸载。

当升级集群 Kubernetes 版本至 1.31 或更高 时，所有运行中的 Pod 将被 重启。此行为是由于 Kubernetes 1.31 引入的 PodSpec 字段变更所必需，无法避免。详情请参见 Kubernetes issue #129385。

目录 /cpaas/minio（global 集群控制平面）必须至少有 120 GB 的可用磁盘空间。

#从 4.x 升级

#前置条件

请确保当前版本满足以下要求：

#运行检查清单

联系技术支持获取 检查清单脚本，并在目标平台上运行以验证升级准备情况。

#下载软件包

从 Custom Portal 下载 核心软件包。

如果您希望在升级过程中升级集群 Extensions： TODO: add instructions.

此外，进入 Custom Portal 的 CLI Tools 部分，下载 violet 工具。该工具用于上传 Extensions。有关 violet 的更多信息，请参见Upload Packages。

#从 3.x 升级

#前置条件

请确保当前版本满足以下要求：

#运行检查清单

联系技术支持获取 检查清单脚本，并在目标平台上运行以验证升级准备情况。

#下载软件包

从 Custom Portal 下载 核心软件包。

如果您希望在升级过程中升级集群 Extensions，请按以下方式下载 Extensions 软件包：

此外，进入 Custom Portal 的 CLI Tools 部分，下载 violet 工具。该工具用于上传 Extensions。有关 violet 的更多信息，请参见Upload Packages。