#迁移单集群网格

以下阶段用于迁移在单个集群中运行的网格。跨多个集群的网格遵循相同的阶段，但还需执行其他步骤，参见迁移多集群网格。

请按顺序执行各阶段。每个阶段结束时都有必须通过的检查，之后才能开始下一阶段。

1. 为迁移做准备 — 阶段 0。检查集群，记录 Mesh v1 配置，备份所有内容并启动探针。此时不会进行任何更改。
2. 安装 Mesh v2 控制平面 — 阶段 1 和 阶段 2。安装 Kiali 和指标资源，然后在 Mesh v1 旁创建 IstioCNI 和 Istio。不会改动工作负载，并且可以删除这两个资源以执行回滚。
3. 迁移工作负载 — 阶段 3。一次迁移一个命名空间和其中的工作负载，将其迁移到 Mesh v2 修订版本。每次迁移都可以撤销。
4. 迁移网关 — 阶段 4。在每个 Mesh v1 网关旁运行一个 Mesh v2 网关，并将流量切换到该网关。Mesh v1 网关会保留在原处，将其扩缩容至零，直到阶段 5。
5. 停用 Mesh v1 — 阶段 5。手动移除 Mesh v1。此阶段无法回滚：之后如需恢复，必须从备份重新安装 Mesh v1。
6. 完成迁移并迁移可观测性堆栈 — 阶段 6。采用默认修订版本标签，移交证书颁发机构，并将跟踪迁移到 OpenTelemetry v2 和 Jaeger v2。

Mesh v2 会按现状读取网格的 Istio 资源，但不会读取用于配置网格本身的 Mesh v1 资源。在迁移工作负载之前，必须以 Mesh v2 的方式表达对 Mesh v1 控制平面所做的任何更改，参见收集自定义 Istio 配置。

请参见回滚迁移，了解每个阶段可以回滚到的状态；有关最常报告的问题，请参见排查迁移问题。