#升级前准备

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

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

支持的升级路径：

• 从 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 升级

#前提条件

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

#运行检查清单

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

#下载软件包

从 Customer Portal 下载 核心软件包。

如果希望在升级过程中升级集群 Extensions，请按以下步骤操作：

1. 进入路径：[Marketplace - Batch Download - Upgrade - Post-ACP v4.0 Upgrades]
2. 下载 ac-get-app.sh 脚本。
3. 将脚本上传至您环境中 Global 集群的控制节点。
4. 运行脚本：bash ac-get-app.sh。
5. 脚本完成后，将生成的 apps.yaml 导入回 Customer Portal，以同步 Extensions 列表。

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

#从 3.x 升级

#前提条件

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

#运行检查清单

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

#下载软件包

从 Customer Portal 下载 核心软件包。

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

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