创建并评估迁移任务

更新时间:
复制 MD 格式

执行资源迁移前,需要为源 MSE 云原生网关(以下称源网关)和目标云原生 API 网关(以下称目标网关)创建迁移任务。系统评估源网关资源后,会生成资源评估报告,帮助您在迁移执行前识别和处理依赖缺失或配置不兼容问题。本文覆盖创建迁移任务和执行资源评估两个环节,评估报告确认后进入迁移执行阶段。

前提条件

  • 源网关为普通实例标准版或专业版。

  • 已根据峰值请求量、连接数、HTTPS 新建连接、带宽及资源数量选择目标规格并预留容量,规格依据参见目标网关容量说明和 MSE 普通实例能力评估。

  • 已创建云原生 API 网关专享版实例,实例处于运行状态,且与源网关位于同一地域、同一 VPC,并确认目标网关可访问实际后端。

  • 目标网关已关闭弹性扩缩容策略,满足创建迁移任务时的校验条件。关闭弹性扩缩容策略前,应确保固定容量足以覆盖迁移期间的流量。

  • 当前账号具有读取源实例配置和管理目标网关资源的权限。如果控制台提示授权,请按页面指引完成授权。

创建迁移任务

  1. 登录 MSE 控制台,选择源网关所在地域。

  2. 在左侧导航栏选择 云原生网关 > 迁移至云原生 API 网关。

  3. 在 迁移任务 页面单击 创建任务。

  4. 选择待迁移的源网关和已准备好的目标网关,核对实例 ID、名称和规格。

  5. 单击 下一步 提交创建请求,进入该任务的资源评估页面。

说明

当前仅支持普通实例专业版和普通实例标准版迁移到专享实例的云原生 API 网关。任务创建后尚未执行资源迁移,也不会影响源网关的业务流量。

执行资源评估

此步自动针对该迁移任务发起资源扫描与评估,等待评估结果生成后:

  1. 按域名、服务、实例、消费者、路由五个类别检查资源明细,各类别的核对重点见核对关键配置。其中“服务”类别包含来源和服务本身两类信息,“路由”类别包含已发布的待迁移路由及其关联配置信息。

  2. 查看每条资源的支持、执行状态和迁移说明,逐项核对关联策略、插件、认证及后端服务等信息。

  3. 确认各资源差异项,逐项明确在源网关侧修正、在目标网关手工补齐,还是经确认后跳过。

    每条资源会显示自动迁移的支持状态和迁移说明。评估结果中各支持状态的含义与建议动作如下:

支持程度

含义

操作建议

支持

该资源具备自动迁移条件,在迁移范围内的配置可以自动迁移

核对目标配置后,在后续步骤执行迁移并验证实际效果

部分支持

主体或部分配置可自动迁移,但存在不能自动承接的配置

查看迁移说明,确认具体差异和受影响的业务,确认手动补齐或忽略

跳过

该资源不进入自动迁移范围

需要该能力时先进行业务改造后重新评估,无需迁移时确认其依赖影响

核对关键配置

评估结果按资源类别展示,各类别需要重点核对的内容如下:

类别

重点核对内容和注意事项

域名配置

域名、证书、HTTP/2协议、TLS配置、域名级黑/白名单、认证鉴权及插件等

说明

域名级 WAF 和仅绑定系统域名的路由不支持迁移,需手动配置处理

服务配置

来源、服务、服务证书加密和负载均衡等配置

说明
  • 对于不支持迁移的服务,其关联路由也不支持迁移

  • 对于已开启 K8s Ingress 监听的来源,相关配置及 Ingress 类型路由会随服务配置自动迁移至目标网关的 HTTP API(Ingress)类型 API,不在评估报告中单独展示

  • oauth2-proxy 是 OIDC 自动生成的内置路由。目标网关会根据 OIDC 配置创建对应的内部路由,因此该路由标记为跳过,无需迁移

实例配置

参数、安全组规则、实例级黑/白名单、全局认证鉴权、实例级官方插件等

说明
  • 实例级 WAF 和可观测配置需至目标网关手动进行配置处理

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

消费者配置

认证方式、密钥与Token 配置等

路由配置

路径、匹配条件、后端服务、策略(限流、重写、消费者认证等)及路由级插件

说明

路由级 WAF 不支持迁移,需手动配置处理

重新评估

迁移工具不会把源网关的后续变更持续同步到目标网关,也不能通过后续迁移执行获取一份新的源网关配置。若源网关配置在评估后发生变化,或者您需要刷新兼容性结果,请单击 重新评估。重新评估会根据当前源网关资源状态重新更新评估报告,不会自动执行迁移。

后续步骤

请确认迁移范围,并为评估报告中的每项差异确定处理方式后,再进入下一步的迁移执行阶段。后续迁移执行将基于当前已生成的评估报告将相关资源迁移至目标网关,任务一旦进入迁移执行或切流阶段就不支持重新评估。后续具体操作参见执行资源迁移。