Cilium Cheatsheet

Cilium CheatsheetKapitel 08 von 11

Gateway API in Cilium

Stand Cilium 1.20 · Edition 2026.11 · Release-Daten geprüft am 30. Oktober 2026

Eingebauter Controller

Cilium implementiert die Gateway API. CRDs vorab installieren, mindestens v1.6.1, die Doku zu 1.20.4 installiert v1.6.3. Cilium führt Gateway API v1.7.0 (29.10.2026) noch nicht. Pflicht: GatewayClass, Gateway, HTTPRoute, GRPCRoute, BackendTLSPolicy, ReferenceGrant, TLSRoute. Optional ListenerSet und TCPRoute/UDPRoute (seit Gateway API 1.6 GA, v1; Traffic läuft am Envoy vorbei direkt auf den Gateway-Service; im Host-Network-Modus nicht nutzbar). Fehlt eine optionale CRD, ist das Feature aus. Gateway-Service per Default vom Typ LoadBalancer.

Voraussetzungen: kubeProxyReplacement=true, l7Proxy=true (Default), gatewayAPI.enabled=true. Ohne bpf.tproxy=true (beta) läuft der Redirect zu Envoy über iptables-TPROXY: fehlen die Netfilter-Module, laufen Verbindungen in Timeouts. GatewayClass heißt cilium.

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata: {name: web-gw, namespace: shop}
spec:
  gatewayClassName: cilium
  listeners:
  - {name: http, port: 80, protocol: HTTP}
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata: {name: web, namespace: shop}
spec:
  parentRefs: [{name: web-gw}]
  rules:
  - matches:
    - path: {type: PathPrefix, value: /}
    backendRefs: [{name: web, port: 80}]