本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文,但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况,请以原始 英文 版本为准,且原始英文版本为权威文本。

Ingress NGINX 退役指南

Kubernetes SIG 网络和安全响应委员会宣布了 Ingress NGINX 项目的退役。上游的最佳努力维护,以及所有相关的上游发布、Bug 修复或安全更新于2026年3月结束。

为了支持用户在此过渡期间,

SUSE 提供了延长的支持时间表和清晰的迁移路径到 Traefik。

本指南集中提供了根据您的特定部署场景进行操作的信息。

支持与时间表

对于无法立即迁移的组织,SUSE Rancher Prime LTS 为 RKE2 版本 1.35 提供了延长支持。

Ingress NGINX 的延长支持

SUSE Rancher Prime LTS 将为 Ingress NGINX 组件在 2027 年 12 月前提供关键和重要的常见漏洞(CVE)补丁。在此期间不会添加新功能。

按环境划分的迁移路径

对于准备迁移的组织,SUSE 提供了通往 Traefik 的支持路径。

Traefik 包含一个兼容层,可以解释许多现有的 Ingress NGINX 注释。在下面识别您的集群环境,以找到正确的迁移方法。

独立的 RKE2 集群

对于当前使用 Ingress NGINX 的独立或导入的 RKE2 集群,请遵循官方 独立 RKE2 集群的迁移指南

迁移过程涉及四个阶段的策略:

  1. *双Ingress控制器设置:*在Ingress NGINX旁边启用Traefik,使用临时的、无冲突的端口。

  2. *并行迁移和验证:*复制Ingress资源并测试Traefik对现有注释的处理。

  3. *最终切换:*去除Ingress NGINX并配置Traefik使用标准端口。

  4. *清理:*删除遗留的Ingress对象。

RKE2上的Rancher服务器(本地群集)

在迁移Rancher本地集群时,Rancher Ingress资源需要特定处理以防止锁定。遵循特定的 在RKE2集群中将Rancher Ingress迁移到Traefik的指南。本指南基于独立迁移阶段,但包括针对Rancher管理服务器量身定制的步骤。

下游RKE2集群(由Rancher提供)

对于由 SUSE Rancher Prime 提供和管理的 RKE2 集群,迁移选项直接集成在用户界面中。

此迁移选项仅在 Rancher v2.13.5+ 和 v2.14 中可用。

集群配置界面提供了双模式迁移选项。这使您可以安全地测试并直接从集群管理屏幕将流量从 Ingress NGINX 迁移到 Traefik。

在托管 Kubernetes 上的 Rancher(Amazon EKS、Azure AKS、Google GKE)

如果您在托管 Kubernetes 服务上运行 SUSE Rancher Prime,例如 Amazon Elastic Kubernetes Service (EKS)Azure Kubernetes Service (AKS)Google Kubernetes Engine (GKE),建议迁移到 Traefik。

SUSE Rancher Prime 客户可以利用应用程序集合来部署和管理 Traefik 代理。

对其他 SUSE 产品的影响

Ingress NGINX 的退役影响其他

SUSE 产品

以以下方式:

  • SUSE Storage:对 Longhorn 后端没有影响。但是,管理员必须重新配置他们的 Ingress 以升级 Longhorn UI。有关更多信息,请参阅 创建带基本身份验证的 Ingress Traefik

  • SUSE® Rancher Prime: Continuous Delivery:配置 webhook 服务受到影响。有关更多信息,请参阅 Fleet 文档

  • 其他项目文档中的 Ingress NGINX 引用已被删除。