← 返回知识中心

Ingress-NGINX 停止维护后:迁移到 Gateway API

Ingress-NGINX 已于 2026 年 3 月停止维护。现有实例仍会转发流量,但不再获得缺陷和安全修复。迁移不是重命名清单,而是验证网络行为。

V
Virtek 工程编辑部系统集成与运维

发现真实使用情况

检查所有集群、命名空间、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 升级责任明确。

需要适合业务的
技术架构?

我们将分析输入条件、风险和限制,并提出有依据的解决方案。

咨询工程师↗︎