For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Examples
This section contains step-by-step examples showing how to migrate common Ingress NGINX configurations to kgateway using the ingress2gateway tool.
Each example walks through the following steps:
- Creating a sample Ingress manifest.
- Running
ingress2gatewayto convert it. - Reviewing the generated Gateway API and kgateway resources.
- Applying them to your cluster.
Pick the example that matches your use case, or work through them all to get familiar with the migration workflow.
Basic Ingress
Convert a simple Ingress resource to a Gateway and HTTPRoute.
Session Affinity
Convert Ingress NGINX session affinity annotations to a kgateway BackendConfigPolicy.
Rate Limiting
Convert Ingress NGINX rate limit annotations to a kgateway TrafficPolicy.
CORS
Convert Ingress NGINX CORS annotations to a kgateway TrafficPolicy.
SSL Redirect
Convert Ingress NGINX SSL redirect annotations to an HTTPRoute RequestRedirect filter.
External Auth
Convert Ingress NGINX auth-url annotations to a kgateway external auth GatewayExtension.
Canary Deployments
Convert Ingress NGINX canary annotations to weighted HTTPRoute backends.
Backend TLS
Convert Ingress NGINX backend TLS annotations to a kgateway BackendConfigPolicy.