Migrating to Gateway API: Ingress2Gateway 1.0 Unleashed
Ingress2Gateway exists to simplify the often complex migration from Ingress to Gateway API. As Kubernetes evolves, the need for a more modular and extensible API becomes clear. Ingress2Gateway acts as an assistant, helping teams confidently navigate this transition while addressing the challenges that arise from implementation-specific annotations and configurations.
How does it work? Ingress2Gateway translates Ingress resources and their associated annotations into the Gateway API format. It supports over 30 common annotations, ensuring that your configurations remain intact. The tool also warns you about any untranslatable configurations and offers suggestions for adjustments. To guarantee that the generated Gateway API behaves equivalently to your original Ingress-NGINX setup, it runs integration tests, giving you peace of mind during the migration process.
In production, you’ll want to install Ingress2Gateway easily using Go or Homebrew. For example, you can run go install github.com/kubernetes-sigs/ingress2gateway@v1.0.0 or brew install ingress2gateway. When you're ready to translate your manifests, use commands like ingress2gateway print --input-file my-manifest.yaml --providers=ingress-nginx > gwapi.yaml. Keep in mind that you can specify different emitters like agentgateway, envoy-gateway, or kgateway to customize your output. This flexibility is crucial for aligning with your specific architecture and needs.
Key takeaways
- →Install Ingress2Gateway using 'go install' or 'brew install'.
- →Translate Ingress resources with 'ingress2gateway print --input-file my-manifest.yaml'.
- →Utilize integration tests to verify behavioral equivalence with Ingress-NGINX.
- →Specify emitters for tailored output using the '--emitter' flag.
- →Support over 30 common annotations to ease the migration process.
Why it matters
Migrating to Gateway API can significantly enhance your Kubernetes networking capabilities, providing better modularity and extensibility. Ingress2Gateway streamlines this transition, reducing downtime and configuration errors.
Code examples
go install github.com/kubernetes-sigs/ingress2gateway@v1.0.0brew install ingress2gatewayingress2gateway print --input-file my-manifest.yaml,my-other-manifest.yaml --providers=ingress-nginx > gwapi.yamlWhen NOT to use this
The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.
Want the complete reference?
Read official docsIndustry-standard certifications built by the people behind Linux and Kubernetes. Earn the CKA — the gold standard Kubernetes administrator cert. OpsCanary readers get 30% off year-round with code OPSCANARY3.
Get CKA certified →CiliumCon Returns: Scaling eBPF Networking at KubeCon 2026
CiliumCon is back, and it's crucial for anyone involved in Kubernetes networking. With Cilium as the de facto CNI, understanding its eBPF foundation is key to managing workloads at scale. Don't miss out on the insights that could elevate your cloud-native architecture.
OVHcloud Joins CNCF: What This Means for Kubernetes in Europe
The CNCF's new partnership with OVHcloud marks a significant shift for Kubernetes in Europe. With OVHcloud operating thousands of production Kubernetes clusters using Cilium, this collaboration promises enhanced networking and security for multi-tenant environments.
Migrating to ALB: Mastering oauth2-proxy in Kubernetes
Switching from NGINX Ingress to ALB can be tricky, especially when handling oauth2-proxy. Learn how to configure oauth2-proxy to work seamlessly with ALB's OIDC authentication capabilities.
Get the daily digest
One email. 5 articles. Every morning.
No spam. Unsubscribe anytime.