Ingress2Gateway 用户指南：支持的所有 Ingress 控制器和转换策略详解

Ingress2Gateway 用户指南支持的所有 Ingress 控制器和转换策略详解【免费下载链接】ingress2gatewayConvert Ingress resources to Gateway API resources项目地址: https://gitcode.com/gh_mirrors/in/ingress2gateway 你是否正在为 Kubernetes Ingress NGINX 的退役而烦恼想要从传统的 Ingress 平滑迁移到现代化的 Gateway API 吗那么 Ingress2Gateway 就是你的完美解决方案这款强大的转换工具能够帮助你轻松将各种 Ingress 控制器资源转换为标准的 Gateway API 资源让你的 Kubernetes 网络配置迈入新时代。什么是 Ingress2GatewayIngress2Gateway是由 Kubernetes SIG-Network 子项目管理的开源工具专门用于将 Ingress 资源和特定提供商的 CRD 转换为 Gateway API 资源。随着 Kubernetes 社区宣布 Ingress NGINX 即将退役Ingress2Gateway 成为了迁移到 Gateway API 的关键桥梁。该工具支持多种流行的 Ingress 控制器包括 ingress-nginx、Traefik、Kong、Istio、GCE 等能够处理复杂的注解转换和资源配置让你的迁移过程更加顺畅。支持的 Ingress 控制器完整列表Ingress2Gateway 目前支持以下主流 Ingress 控制器的转换1.ingress-nginx- Kubernetes 社区标准支持位置: pkg/i2gw/providers/ingressnginx/核心功能: 金丝雀发布、URL 重写、重定向、CORS 配置、超时设置特色转换:金丝雀权重路由 (canary-weight)SSL 透传 (ssl-passthrough)后端 TLS 验证 (proxy-ssl-verify)2.Traefik- 云原生代理支持位置: pkg/i2gw/providers/traefik/核心功能: TLS 配置、入口点管理、HTTP/HTTPS 重定向特色转换:自动 HTTPS 重定向 (router.entrypoints: websecure)自定义入口点配置智能 TLS 处理3.Kong- API 网关支持位置: pkg/i2gw/providers/kong/核心功能: 方法匹配、头部匹配、插件集成特色转换:HTTP 方法匹配 (konghq.com/methods)自定义头部路由 (konghq.com/headers.*)插件配置转换4.Istio- 服务网格支持位置: pkg/i2gw/providers/istio/核心功能: Gateway 和 VirtualService 转换特色转换:复杂重写规则处理跨命名空间引用 (ReferenceGrant)协议转换 (HTTP2/GRPC → HTTPS)5.GCE- Google Cloud Engine支持位置: pkg/i2gw/providers/gce/核心功能: GKE Ingress 特定功能特色转换:内部/外部负载均衡器Cloud Armor 安全策略自定义健康检查6.NGINX- NGINX 官方控制器支持位置: pkg/i2gw/providers/nginx/核心功能: SSL 服务、gRPC、WebSocket 支持特色转换:gRPC 服务转换 (nginx.org/grpc-services)WebSocket 支持通知HSTS 头部配置7.其他支持的控制器APISIX: 高性能 API 网关Cilium: eBPF 网络方案OpenAPI 3: 基于 OpenAPI 规范的配置核心转换策略详解 架构设计Provider 与 Emitter 分离Ingress2Gateway 采用创新的双组件架构Provider提供者: 读取 Ingress 资源和特定提供商的 CRD将其转换为通用的中间表示IREmitter发射器: 将中间表示转换为最终的 Gateway API 输出这种设计使得工具既灵活又易于扩展支持多种输出格式standard: 标准 Gateway API 资源默认envoy-gateway: Envoy Gateway 特定资源gce: Google Cloud Engine 特定配置agentgateway: Agent Gateway 实现airlock-microgateway: Airlock 微网关kgateway: KGateway 实现 Ingress 字段到 Gateway API 的映射关系Ingress 字段Gateway API 配置ingressClassNameGateway 的gatewayClassNamedefaultBackend无主机名的 Gateway Listener 通配 HTTPRoutetls[].hostsHTTPS Listener (端口 443, TLS 终止模式)tls[].secretNameGateway Listener 的certificateRefsrules[].host独立的 HTTP Listener (端口 80)rules[].http.paths[].pathHTTPRouterules[].matches[].path.valuerules[].http.paths[].pathTypeHTTPRoute 路径匹配类型⚙️ 冲突处理规则Ingress2Gateway 采用确定的处理顺序来解决配置冲突创建时间优先: 最早创建的 Ingress 资源具有最高优先级名称空间/名称排序: 如果创建时间相同按命名空间和名称排序冲突报告: 对于冲突的规则如相同路径但不同后端会报告错误实用转换示例示例 1: ingress-nginx 金丝雀发布# 原始 Ingress 配置 apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: canary-demo annotations: nginx.ingress.kubernetes.io/canary: true nginx.ingress.kubernetes.io/canary-weight: 20转换为 Gateway API 后会生成带有权重配置的 HTTPRoute实现精确的流量分流。示例 2: Traefik HTTPS 重定向# Traefik 特定配置 annotations: traefik.ingress.kubernetes.io/router.tls: true traefik.ingress.kubernetes.io/router.entrypoints: websecureIngress2Gateway 会自动生成 HTTP→HTTPS 重定向路由确保所有 HTTP 流量都重定向到 HTTPS。示例 3: Kong 方法匹配# Kong 特定配置 annotations: konghq.com/methods: POST,GET转换为 Gateway API 的 HTTPRoute包含精确的 HTTP 方法匹配规则。安装与使用指南快速安装方法通过 Go install 安装:go install github.com/kubernetes-sigs/ingress2gatewayv1.0.0通过 Homebrew 安装:brew install ingress2gateway从源码构建:git clone https://gitcode.com/gh_mirrors/in/ingress2gateway cd ingress2gateway make build go install .基本使用命令转换集群中的所有 ingress-nginx 资源:ingress2gateway print --providersingress-nginx从文件转换 Traefik 配置:ingress2gateway print --providerstraefik --input-filetraefik-ingress.yaml指定命名空间和输出格式:ingress2gateway print --providersistio --namespaceproduction --outputjson常用命令行选项选项简写默认值说明--providers-必填逗号分隔的提供者列表--input-file--从文件读取支持 YAML/JSON--namespace-n-指定命名空间范围--all-namespaces-Afalse跨所有命名空间--output-oyaml输出格式: yaml, json, kyaml--emitter-standard发射器类型迁移最佳实践 1. 评估现有配置在开始迁移前使用 Ingress2Gateway 的--dry-run模式评估转换结果:ingress2gateway print --providersingress-nginx --dry-run 2. 逐步迁移策略从简单的 Ingress 开始逐步处理复杂配置优先迁移生产环境外的测试集群使用金丝雀发布验证转换结果⚠️ 3. 注意事项注解转换: 不是所有注解都能完美转换部分需要手动调整功能差异: Gateway API 的功能集与 Ingress 有所不同测试验证: 转换后务必进行全面的功能测试 4. 监控与验证使用转换报告检查未转换的注解验证 Gateway API 资源的正确性监控应用行为是否发生变化高级特性与扩展自定义 Emitter 支持Ingress2Gateway 支持自定义发射器开发允许你为特定的 Gateway API 实现生成优化配置。查看 docs/emitters.md 了解如何开发自己的发射器。通知系统工具内置通知系统会详细报告:✅ 成功转换的配置⚠️ 部分支持的注解❌ 无法转换的功能 手动调整建议实验性功能支持通过--allow-experimental-gw-api标志可以启用实验性 Gateway API 功能如 URLRewrite 等高级特性。版本兼容性Ingress2Gateway 版本支持的 Gateway API 版本v1.0v1.5.0 (向前兼容 v1.4)社区与贡献Ingress2Gateway 是 Kubernetes SIG-Network 的子项目欢迎社区贡献:报告不支持的注解或功能提交新的 Provider 支持改进现有转换逻辑添加测试用例查看 CONTRIBUTING.md 了解如何参与贡献。总结Ingress2Gateway 为 Kubernetes 用户提供了从传统 Ingress 到现代 Gateway API 的平滑迁移路径。通过支持多种流行的 Ingress 控制器和灵活的转换策略它大大降低了迁移的技术门槛和风险。无论你使用的是 ingress-nginx、Traefik、Kong 还是其他控制器Ingress2Gateway 都能帮助你顺利完成迁移享受 Gateway API 带来的标准化、扩展性和未来兼容性优势。立即开始你的迁移之旅拥抱 Kubernetes 网络的新时代【免费下载链接】ingress2gatewayConvert Ingress resources to Gateway API resources项目地址: https://gitcode.com/gh_mirrors/in/ingress2gateway创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考