#升级前准备

对于 ，从 3.x 到 4.x 的升级过程与 4.x 系列 内的升级过程有显著差异。以下部分将分别介绍这两种升级路径：

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

支持的升级路径：

• 从 3.18 → 4.0
• 从 3.16 → 4.0

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

#重要说明

从 4.0 开始：

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

• 所有自定义的定期 ETCD 备份任务都将被弃用。升级前：

  • 备份并删除所有 ETCD 备份任务，etcd-backup-default 除外。
  • 删除备份任务不会移除任何现有的 ETCD 快照；只会删除任务本身。
  • 升级后，您可以按需重新配置 etcd-backup-default 任务。

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

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

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

#从 4.x 升级

#前提条件

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

#运行检查清单

联系技术支持获取 检查清单脚本，并在目标平台上运行，以验证是否具备升级条件。

#下载软件包

从 Customer Portal 下载 Core Package。

如果您希望在升级期间同时升级集群 Extensions，请按以下步骤操作：

1. 在 Customer Portal 的 CLI Tools 部分下载 violet 工具。上传 Extensions 需要使用此工具。有关 violet 的更多信息，请参见 上架软件包。

2. 在任意一台可访问 平台端点的机器上，运行 violet list 以列出当前环境中的扩展，并将输出导出到 ./apps.yaml。

   violet list \
     --platform-address "https://<your-platform-domain>" \
     --platform-token "<platform_token>" \
     --output-file "./apps.yaml"

   建议优先使用 --platform-token，而不是 --platform-password，以避免在 shell 历史记录和进程列表（ps aux）中暴露密码。

3. 将导出的 apps.yaml 文件导入 Customer Portal，以对齐扩展列表。

#从 3.x 升级

#前提条件

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

#运行检查清单

联系技术支持获取 检查清单脚本，并在目标平台上运行，以验证是否具备升级条件。

#下载软件包

从 Customer Portal 下载 Core Package。

如果您希望在升级期间同时升级集群 Extensions，请按如下方式下载 Extensions Package：

此外，请在 Customer Portal 的 CLI Tools 部分下载 violet 工具。上传 Extensions 需要使用此工具。有关 violet 的更多信息，请参见 上架软件包。