Skip to content

HTTPRoutes for Ingress

HTTPRoute is the recommended way to expose HTTP services.

Minimal example

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: web
  namespace: web
spec:
  parentRefs:
    - name: shared-gateway
      namespace: ingress-system
  hostnames:
    - web.example.com
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /
      backendRefs:
        - name: web
          port: 80

Common patterns

Path split (for example /api and / to different backends).
Header-based routing for advanced traffic control.
Weighted backend refs for gradual cutovers.

Validation checklist

Route Accepted by Gateway controller.
Route ResolvedRefs is true.
Service endpoints are healthy.
Requests reach intended backend.

Further reading