Istio Quick Reference

Istio Quick ReferenceChapter 08 of 10

Gateway API in Istio

As of Istio 1.31 · Edition 2026.11 · Release data checked on 30 October 2026

Status in 1.31

Istio 1.31 builds on Gateway API v1.6.0 (Gateway, HTTPRoute, GRPCRoute, TLSRoute, TCPRoute, ListenerSet), an equal alternative to Gateway/VirtualService. CRDs are not bundled: 1.31 expects v1.6.0 (TCPRoute minimum v1.6.0, TLSRoute v1.5.0); CRDs below their minimum are silently not processed, istioctl analyze reports IST0176. New projects: Gateway API; networking.istio.io stays, both coexist.

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata: {name: web, namespace: istio-system}
spec:
  gatewayClassName: istio
  listeners:
  - name: https
    hostname: www.istio-quickref.de
    port: 443
    protocol: HTTPS
    allowedRoutes: {namespaces: {from: All}} # prod: Selector
    tls:
      certificateRefs:
      - {name: web-cert}
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata: {name: site, namespace: web}
spec:
  parentRefs: [{name: web, namespace: istio-system}]
  hostnames: ["www.istio-quickref.de"]
  rules:
  - matches: [{path: {type: PathPrefix, value: /}}]
    backendRefs: [{name: nginx, port: 80}]