Willkommen im Trainingslager
Wenig lesen, viel tippen. Dieses Buch bringt dir die Kubernetes Gateway API so bei, wie du sie beim Kunden brauchst: erst mit kind auf dem Laptop, dann auf einem hochverfügbaren RKE2-Cluster auf Proxmox – mit Envoy Gateway als Hauptwerkzeug und Cilium als zweiter Implementierung.
Du kennst Ingress. Genau dort setzen wir an: Jeder Tag nimmt ein Stück Ingress-Wissen, übersetzt es in Gateway, Route und Policy und zeigt, was du vorher nur mit Annotationen hinbekommen hast.
Die Trainingsregeln
- Tippen, nicht kopieren. Jeder Befehl einmal selbst.
- Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
- Status zuerst. Bevor du
curldebuggst, liest du die Conditions von Gateway und Route. Die Gateway API sagt dir fast immer selbst, was nicht stimmt. - Kontrollpunkt bestehen. Erst wenn das Prüfskript nur ✔ zeigt, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab. Lab-CA, Passwörter, Tokens: niemals produktiv verwenden.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle mit erwarteter Ausgabe |
| Kontrollpunkt | Prüfskript: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Produktion anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| Gelände | 0 | Trainingsgelände aufbauen |
| A – Grundlagen in kind | 1 | Von Ingress zur Gateway API |
| 2 | Erstes Gateway und HTTPRoute | |
| 3 | Filter: Redirect, Rewrite, Header, Mirroring, Timeouts | |
| 4 | TLS: cert-manager, HTTPS-Redirect, SNI, Passthrough, BackendTLSPolicy | |
| B – Traffic-Steuerung | 5 | Canary und Blue-Green |
| 6 | gRPC, TCP und UDP | |
| 7 | Mehrmandantenfähigkeit: allowedRoutes, ReferenceGrant, ListenerSet | |
| C – RKE2 auf Proxmox | 8 | Cluster bauen: OpenTofu, Ansible, RKE2 HA, Cilium |
| 9 | Gateways auf RKE2: LB-IPAM, Envoy Gateway, Cilium-GatewayClass | |
| 10 | Envoy-Gateway-Erweiterungen: Traffic- und Security-Policies | |
| D – Produktion | 11 | Observability: Metriken, Access Logs, Tracing |
| 12 | Hochverfügbarkeit, Upgrades, Conformance | |
| 13 | Ingress-Migration mit ingress2gateway | |
| 14 | Wettkampf: Desaster-Drills | |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Trainingsgelände
Teil A/B: Laptop – kind "gw-lab" Teil C/D: Proxmox – RKE2 (lab.internal)
┌──────────────────────────────────┐ ┌──────────────────────────────────────┐
│ cloud-provider-kind (LB-IPs) │ │ rke2-cp-1..3 10.10.20.11-13 (etcd) │
│ ns envoy-gateway-system: │ │ rke2-wk-1..3 10.10.20.21-23 │
│ Envoy Gateway (Class "eg") │ │ API-VIP 10.10.20.10 (kube-vip) │
│ ns infra: Gateway "web" │ ──► │ Cilium: kube-proxy-Ersatz, │
│ ns shop: shop-v1, shop-v2 │ │ LB-IPAM + L2 (.100-.120) │
│ ns payments: payments (gRPC) │ │ GatewayClasses "eg" und "cilium" │
│ *.gw.localtest.me, Lab-CA │ │ *.apps.lab.internal, Lab-CA │
└──────────────────────────────────┘ └──────────────────────────────────────┘
Teil A und B laufen komplett auf dem Laptop. Ab Teil C brauchst du einen Proxmox-Host mit genug Ressourcen für sechs VMs (Details an Tag 8).
Tipp: Getestet mit Gateway API v1.6, Envoy Gateway v1.9.2, kind 0.33 (Kubernetes 1.37) und cloud-provider-kind 0.12.0. Wenn ein Feld abweicht:
kubectl explainund die Doku unter gateway-api.sigs.k8s.io bzw. gateway.envoyproxy.io.
Der Begleitcode
Alle Dateien aus diesem Buch liegen öffentlich auf GitHub: https://github.com/thomaszachmann/gateway-api-zum-anfassen. Wie du sie holst, zeigt Tag 0.
Los geht’s.
Thomas Zachmann, Oktober 2026