For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Basic Ingress
Verified Code examples on this page have been automatically tested and verified.Convert a basic NGINX Ingress to Gateway API resources with the ingress2gateway tool.
This example shows the simplest case: an Ingress with no special annotations. The tool converts it into a Gateway and HTTPRoute.
Before: Ingress
cat <<'EOF' > basic-ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: demo-localhost
spec:
ingressClassName: nginx
rules:
- host: demo.localdev.me
http:
paths:
- backend:
service:
name: echo-backend
port:
number: 8080
path: /
pathType: Prefix
EOFConvert
ingress2gateway print --providers=ingress-nginx --emitter=agentgateway --input-file basic-ingress.yaml > basic-agentgateway.yamlAfter: Gateway API resources
cat basic-agentgateway.yamlapiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: nginx
spec:
gatewayClassName: agentgateway
listeners:
- hostname: demo.localdev.me
name: demo-localdev-me-http
port: 80
protocol: HTTP
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: demo-localhost-demo-localdev-me
spec:
hostnames:
- demo.localdev.me
parentRefs:
- name: nginx
rules:
- backendRefs:
- name: echo-backend
port: 8080
matches:
- path:
type: PathPrefix
value: /Apply and verify
kubectl apply -f basic-agentgateway.yaml
kubectl get gateways
kubectl get httproutesWas this page helpful?
