Ingress-NGINX 退役之后:逐路由迁移,而不是标志日重写

举报
yd_242310901 发表于 2026/11/12 03:14:54 2026/11/12
【摘要】 Ingress-NGINX 在 2026 年 3 月退役,仓库归档,不再有发布、bugfix 或安全补丁。Kubernetes SIG Network 的迁移建议是 Gateway API,ingress2gateway 工具(v1.0.0 于 2026 年 3 月 20 日发布)可以把现有的 Ingress 资源转换为 Gateway API 资源。但迁移的成败不在“翻译 YAML”,而在...

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 退役是一个确定的时间点,但迁移的节奏应该由“注解是否被检查过”和“证书是否正确挂载”来决定,而不是由截止日期倒推。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。