本文介绍从 Chaos Mesh 1.x 升级至 2.0 的详细步骤。Chaos Mesh 2.0 引入了一些新功能，并修复了许多问题。Chaos Mesh 2.0 重构了一部分代码，因此需要做一些额外的操作从 Chaos Mesh 1.x 升级到 2.0。

升级工具

CRD 在 Chaos Mesh 2.0 中发生了变化，旧版本实验的 YAML 文件无法在 Chaos Mesh 2.0 上运行。如果希望继续使用旧版本实验的 YAML 文件，则需要导出并升级这些文件，并在 Chaos Mesh 升级后重新导入。

为了简化升级过程，Chaos Mesh 2.0 提供了以下升级工具：

  • migrate.sh：用于自动导出并升级实验 YAML 文件、升级 CRD、导入升级后的 YAML 文件。
  • schedule-migration：用于将指定的旧版 YAML 文件更新为新版 YAML 文件。

要获取升级工具，建议将 Chaos Mesh 项目克隆至本地执行 make schedule-migration.tar.gz，或是从 https://mirrors.chaos-mesh.org/v2.0.0/schedule-migration.tar.gz 下载。使用以下命令将其解压，即可得到上述两个工具：

  1. tar xvf ./schedule-migration.tar.gz

该压缩包打包的 schedule-migration 工具仅适用于 Linux x86_64 平台，其他操作系统 / 架构的用户需要自行编译。

第 1 步：导出并升级实验

你可以使用升级工具 migrate.sh 自动导出并升级实验。在运行之前，请确保当前用户有足够的权限访问集群。

假设 migrate.sh 位于当前目录下，并且 schedule-migration 工具也置于该目录下，请执行以下命令导出并升级实验：

  1. bash migrate.sh -e

在当前目录下生成了许多 YAML 文件，这些就是被导出的实验文件。导出的实验文件已经被自动升级。

此外，你也可以使用 schedule-migration 工具只升级指定的旧版 YAML 文件，请运行以下命令：

  1. ./schedule-migration <path-to-old-yaml> <path-to-new-yaml>

在你指定的 YAML 文件路径，就可以获取升级后的新版 YAML 文件。在删除旧资源后重新应用新 YAML 文件即可完成更新。

第 2 步：升级 CRD

当使用 Helm 升级 Chaos Mesh 前，为了能最大程度保证升级成功，请运行以下命令手动升级 CRD：

  1. bash migrate.sh -c

即可看到 CRD 被删除后重新添加。

第 3 步：升级 Chaos Mesh

由于 2.0 的改动较大，推荐在卸载 1.x 后重新进行安装。具体安装步骤，请参考使用 Helm 安装（生产推荐）。

第 4 步：导入实验

Chaos Mesh 2.0 对实验定义进行了一些修改，需要升级旧版实验文件后才能继续使用。

在导出的实验文件的同一目录下，请运行以下命令导入实验：

  1. bash migrate.sh -i

问题反馈

如果在升级过程中遇到任何问题，请将命令行输出提交至 slack 或在 Github 上新建一个 issue。感谢你的反馈，Chaos Mesh 团队很乐意帮助解决。