发现真实使用情况
检查所有集群、命名空间、Helm 发布和 GitOps 仓库,清点 IngressClass、控制器、外部负载均衡、证书和 DNS。单独导出 rewrite、认证、CORS、限速、canary、snippet、超时和请求体限制等注解,因为它们往往决定真实行为。
为每条路由记录负责人、关键级别、域名、后端、TLS、外部地址、源地址要求和 SLO。没有负责人的 Ingress 是风险,不应直接自动转换。
选择 Gateway API 实现
Gateway API 定义通用资源,但数据面和扩展能力取决于实现。比较 HTTPRoute、GRPCRoute、TLSRoute、策略、云负载均衡、WAF、服务网格、可观测性和供应商生命周期。
确认支持的配置文件和 CRD 版本。平台团队管理 GatewayClass,基础设施团队管理 Gateway,应用团队管理 Route,从而形成比共享注解更清晰的权限边界。
转换行为而不是 YAML
Ingress2Gateway 可生成起点,但无法证明控制器专有注解完全等价。建立映射表,包含旧规则、新资源或策略、预期行为、测试和例外负责人。
重点验证路径优先级、正则和重写、头部、客户端 IP、WebSocket、gRPC、会话保持、mTLS、请求限制、重定向和错误处理。不要直接复制 snippet,应转换为策略、过滤器或应用逻辑。
并行迁移
在旧控制器旁部署新控制器并使用独立地址,执行合成和集成测试,再通过受控 TTL 的 DNS 或负载均衡逐步迁移流量。比较响应码、延迟、TLS、后端指标和安全日志。
预先定义停止条件、快速回退和观察窗口。关键路由分组迁移,避免共享策略错误同时影响全部服务。
安全下线
确认旧地址已无流量,删除公共入口和多余权限,保留配置与测试证据。更新模板、CI 策略和平台目录,防止新 Ingress 再次出现。
成功不仅是路由可用,还包括权限清晰、实现仍受维护、测试可重复以及 Gateway API 升级责任明确。

