执行资源迁移

更新时间:
复制 MD 格式

评估通过后,在迁移任务中按资源分类分阶段执行资源和配置导入。导入会创建、复用或更新目标端资源,执行完成后需要分别核对资源执行结果和实际配置,执行迁移不会自动切换业务流量。

前提条件

  • 已完成创建并评估迁移任务,并进入迁移执行阶段。

  • 已确认部分支持、不支持及手工补齐项的处理方案并完成处理和重评估。

  • 已检查目标网关同名域名、消费者和 API 的存在及用途,确认本次迁移更新相关配置。

  • 已确认目标网关运行状态正常,且配额、权限等依赖项满足本次迁移执行需要。

  • 迁移期间请尽量保持源网关配置稳定。

迁移顺序

按以下依赖关系顺序执行。域名与服务可以任选先后,二者均处理完成后再执行实例配置。

顺序

资源类别

迁移内容

前置条件

1

域名配置

自定义域名、域名配置(TLS 等)、域名关联黑/白名单和插件等

无其他类别前置依赖

1

服务配置

来源和服务及服务配置;系统先处理所需来源,再处理服务

无其他类别前置依赖

2

实例配置

网关参数、标签、安全组规则、全局认证鉴权、实例级黑/白名单及插件配置

域名、服务中的可执行资源均已成功或已跳过

3

消费者配置

支持的消费者与凭证配置

实例及其前置类别已处理完成

4

路由配置

路由及兼容的策略、插件配置与消费者授权关系

消费者及其前置类别已处理完成

不要仅为解锁后续步骤而跳过仍需使用的资源。跳过任一前置资源前,先阅读跳过资源,确认其对依赖资源的影响。

执行导入

请按以下流程逐个资源类别执行导入:

  1. 在迁移执行页,查看每个配置类别下的资源条目和迁移说明,确认各资源状态符合预期。

  2. 按照迁移顺序,单击各配置类别中的执行。执行当前类别前,请先确认其前置类别已处理完成。

  3. 对于无需迁移的资源类别,可单击该类别对应的跳过,并同时检查其关联的依赖资源。跳过细节可参见跳过资源。

  4. 每个类别执行完成后,查看执行进度,并检查资源的目标信息、执行状态以及更新后的迁移说明。

  5. 如存在异常项,请在执行失败的资源条目的迁移说明中查看失败原因,并进行问题定位和处理:

    • 如果修复的是目标网关配置,可直接单击执行,重试导入;重试细节可参见重新执行。

    • 如果修改了源网关配置,则需要重新创建迁移任务并完成评估,再进入迁移执行页重新执行。

  6. 异常项处理完成后,请在目标网关核对配置并确认无误,再继续执行下一类别。

注意:

  • 任务提交成功,仅表示系统已受理执行请求,不代表导入已经完成。

  • 某一类别执行结束后,其下资源状态可能同时包含成功、失败和跳过,请根据执行结果分别处理。

  • 资源条目中展示的支持状态仅反映评估快照中的评估结果,实际执行结果仍会受到目标网关配置、网络环境等因素影响。请以实际执行结果和目标网关上的最终配置为准。

  • 如有其他问题,请参见常见问题与故障处理。

检查迁移结果

按下表确认资源执行状态,并采取对应的后续操作:

执行状态

含义

后续操作

待执行

尚未完成该资源的执行

确认状态后发起执行导入

执行中

正在准备或执行导入

等待执行结果,避免重复提交

成功

资源已经完成本次处理

到目标端核对配置,并检查关联项是否完整

部分失败

资源关联项中存在未完成的部分

查看具体失败项和迁移说明,并根据原因修正,再决定重新执行或重新创建任务

失败

该项迁移未完成

根据原因修正,再决定重新执行或重新创建任务

跳过

本任务不会继续导入该项

确认该能力是否忽略或已手工补齐,以及依赖资源是否受影响

执行结束不代表所有资源都已成功,请以各资源的执行状态和目标配置为准。以下为建议检查的要点。

域名配置

核对目标域名、证书和 TLS 设置,以及域名关联的插件与黑白名单。域名本身创建成功,不代表附属配置全部成功。系统分配域名不会作为自定义域名迁移。

服务配置

核对来源与服务的实际绑定、服务配置、策略与连通性。在目标网关验证服务发现和后端连通性,不能只依据名称相同判断配置等效。对于不支持迁移的服务,其关联路由也将跳过迁移。

实例配置

检查网关引擎参数、安全组规则、实例级黑/白名单,以及全局认证鉴权配置,并分别验证允许和拒绝两类请求是否符合预期。

重要

此外,您还需要额外关注以下配置:

  • 网关引擎参数

    • EnableProxyProtocol参数不会迁移。如果网关入口流量通过 SLB 接入,未开启该参数时,网关将无法获取客户端真实 IP,且可能存在流量异常风险。开启EnableProxyProtocol后,对非 Proxy 协议请求无影响;如需关闭该参数,请在确认业务无影响后至云原生 API 网关手动关闭。

    • EnableHttp2在云原生 API 网关中不再作为全局参数管理,其对应配置会随「域名配置」一并迁移到目标网关的域名配置中。

  • 实例级 WAF 与可观测配置

    • 实例级 WAF 配置和可观测相关配置不会自动迁移,需要您在目标网关手动配置。

  • 实例级插件配置

    • 若实例级插件规则中配有match_route等按路由生效的规则,迁移后因路由标识变化可能失效,需由您改配为对应的路由级插件规则。

消费者配置

检查认证方式、密钥与Token 配置等。消费者授权关系将随「路由配置」一并迁移。

路由配置

MSE 上的路由会迁移为云原生 API 网关中的 HTTP API 及其下的路由(Route),业务语义保持不变。检查生成的 HTTP API 及其下各路由的请求路径、请求方法、参数、后端服务、策略、插件和消费者授权关系。重点确认未迁移的路由和被省略的策略,不要仅根据 HTTP API 是否已生成就判断迁移完成。

HTTP API 采用异步导入方式。部分路由校验不通过时,请根据对应路由条目中的失败说明进行处理;其他路由是否迁移成功,请以各自的执行结果为准。

说明
  • 当前仅支持迁移已发布的路由。Ingress 类型路由会随着「服务配置」一并迁移到云原生 API 网关HTTP API(Ingress)类型的 API 中,不会评估报告中展示。

  • 迁移后的 HTTP API 还需要在目标网关完成发布后,才能承接正式流量。导入完成后仍需按照验证并切换流量发布并切换流量。

重新执行与跳过

重新执行

根据失败原因修正后,按修改内容选择处理方式:

  • 若修复的是目标网关配置、配额或依赖等问题,且源端配置没有变化时,可在任务仍处于迁移执行阶段的情况下重新执行对应类别。

  • 若需要修改源网关配置,且已进入执行或流量切换阶段,则请按创建并评估迁移任务中的配置变更流程,重新创建迁移任务并进行评估。

重要

重新执行会使用同一份评估配置快照再次处理该类别中未跳过的可迁移资源,包括已成功资源。域名、消费者、API 等可能会再次更新已有同名对象。重试前应核对目标网关人工修改,不能将重试视为只修复失败项,执行后请重新检查迁移结果。

跳过资源

跳过仅用于已经确认不再由当前任务迁移的资源。

重要

跳过前置资源可能使依赖它的服务、策略或路由无法迁移,如跳过来源可能影响服务;跳过服务、域名或消费者可能影响后续认证策略与路由。操作后应重新查看其关联的资源条目。

同一目标网关已完成资源导入、仅需要迁移另一个负载均衡入口时,可以核验全部所需配置后跳过重复导入,再进入流量切换流程。

后续步骤

当所有需要处理的可执行资源均为成功或跳过,且已确认目标网关配置满足本次流量切换范围时,可以推进任务至流量切换阶段。阶段推进本身不等于 HTTP API 已发布、功能已验证或 DNS 已修改,需继续完成验证并切换流量。