Ingress-NGINX 退役之后:逐路由迁移,而不是标志日重写
Ingress-NGINX 在 2026 年 3 月退役,仓库归档,不再有发布、bugfix 或安全补丁。Kubernetes SIG Network 的迁移建议是 Gateway API,ingress2gateway 工具(v1.0.0 于 2026 年 3 月 20 日发布)可以把现有的 Ingress 资源转换为 Gateway API 资源。
但迁移的成败不在“翻译 YAML”,而在注解。一个被反复强调的教训是:迁移断在“没有人检查过的注解”上,而不是断在你让 AI 写的 YAML 上。proxy-body-size、use-regex、CORS、路径重写有 Gateway API 的等价物;configuration-snippet、auth-url 外部认证、server-snippet 没有标准的映射字段。如果集群里的注解大量落在第二类,你面对的是一个设计工作,而不是一次翻译。
一个可操作的迁移路径是先并行运行,而不是一次性替换。Ingress API 本身是冻结的,不是被移除的,现有的 Ingress 对象继续工作,Kubernetes 没有计划删除该 API。这意味着可以在同一个集群里同时运行旧的 ingress-nginx 和新的 Gateway 控制器,每个 Ingress 对象通过 ingressClassName 声明由哪个控制器服务,流量逐路由、逐主机地移动。一条被验证过的路径是:先用 Traefik 的 NGINX 兼容提供方在运行时翻译已有的注解,覆盖真实迁移团队实际使用的 90% 以上,让流量安全地离开已退役的控制器;再用 ingress2gateway 逐个主机把路由转换为 Gateway API 资源;最后在没有任何东西引用旧控制器时将其退役。
另一个需要提前处理的细节是证书。如果 NGINX Ingress 配置的 Secret 是默认的 NGINX secret,转换后的 Gateway Secret 名称会是空的,必须手动指定。这不是一个可以在转换后“再看看”的问题,证书没有正确挂载意味着迁移后的路由直接不可用。
一个务实的判断是:迁移的目标不是“尽快把所有 Ingress 变成 HTTPRoute”,而是“在旧控制器退役之后,每一条路由都还在正确工作”。逐路由迁移比标志日重写慢,但它把风险分散到了每一次单个 host 的切换上;并行运行让回滚只需要把一个对象切回旧的 ingressClassName,而不是回滚整个集群。Ingress-NGINX 退役是一个确定的时间点,但迁移的节奏应该由“注解是否被检查过”和“证书是否正确挂载”来决定,而不是由截止日期倒推。
- 点赞
- 收藏
- 关注作者
评论(0)