#升级前准备

从 3.x 升级到 4.x 的升级过程，与 4.x 系列 内部的升级过程有很大不同。以下部分将分别介绍这两种升级路径：

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

支持的升级路径：

• 从 4.0 → 4.1
• 从 3.18 → 4.1

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

#重要说明

从 4.0 开始：

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

• 所有自定义的周期性 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 的更多信息，请参见 上架软件包。