升级至 Chaos Mesh 2.0
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
本文档详细指导如何将 Chaos Mesh 从 1.x 版本升级至 2.0。Chaos Mesh 2.0 引入了新特性并修复了大量问题。由于部分代码在 2.0 版本中进行了重构，升级过程需执行额外操作。
升级工具
Chaos Mesh 2.0 的 CRD 定义已变更，旧版实验的 YAML 文件无法在 2.0 环境中运行。如需继续使用这些文件，您需导出并更新 YAML 文件，待升级完成后重新导入。
为简化升级流程，Chaos Mesh 2.0 提供以下工具：
-
migrate.sh：用于自动导出/升级 YAML 文件、更新 CRD 并导入升级后的文件 -
schedule-migration：用于将旧版 YAML 文件更新至最新格式
获取升级工具，推荐将 Chaos Mesh 项目克隆至本地仓库后执行命令 make schedule-migration.tar.gz，或直接从 https://mirrors.chaos-mesh.org/v2.0.0/schedule-migration.tar.gz 下载项目。下载 tar.gz 包后执行以下命令即可获得上述两个升级工具：
tar xvf ./schedule-migration.tar.gz
注意：此包中的 schedule-migration 仅适用于 Linux x86_64 平台。若使用其他操作系统或架构需自行编译。
步骤一：导出并升级实验
使用 migrate.sh 可自动导出并升级实验。执行前请确保拥有足够的集群访问权限。
若 migrate.sh 位于当前目录，请将 schedule-migration 置于同级目录。执行以下命令导出并升级实验：
bash migrate.sh -e
当前目录将生成多个 YAML 文件，这些即自动升级后的实验导出文件。
您也可使用 schedule-migration 工具升级指定旧版 YAML 文件：
./schedule-migration <path-to-old-yaml> <path-to-new-yaml>
在指定路径获取升级后的 YAML 文件。删除旧资源后重新应用新文件即可完成更新。
步骤二：升级 CRD
使用 Helm 升级 Chaos Mesh 前，为提高成功率请手动执行以下命令更新 CRD：
bash migrate.sh -c
此时可观察到 CRD 被删除后重新添加。
步骤三：升级 Chaos Mesh
由于 2.0 版相较 1.x 存在大量变更，建议先卸载 1.x 再安装 2.0。具体步骤请参阅使用 Helm 安装（推荐生产环境）。
步骤四：导入实验
Chaos Mesh 2.0 的实验定义已调整，使用旧版实验文件前需进行升级。
在导出的实验文件目录执行以下命令导入实验：
bash migrate.sh -i
问题反馈
升级过程中如遇问题，请将命令输出提交至 Slack 或在 GitHub 提交 issue。感谢您的反馈，Chaos Mesh 团队将全力协助解决。