Anhang B: Abschlussprüfung
Ziel: Nachweisen, dass du ein Gateway mit Routen, TLS, Policies und Migration allein aufbaust und reparierst · Dauer: 120 min Praxis + 20 min Fragen · Voraussetzung: Tag 14
Regeln
- Cluster: kind
gw-labauf dem Laptop, Stand nach Tag 7 (Envoy Gateway v1.9.2, cert-manager mitClusterIssuer lab-ca,payments-apiaus Tag 7).cloud-provider-kindläuft im zweiten Terminal. - Alles kommt an ein neues Gateway
infra/pruefungmit eigener IP. Hostnames:*.pruefung.gw.localtest.me. Die Lab-Objekte aus Tag 1–7 bleiben unberührt. - Erlaubt:
kubectl explain,--help, Anhang A, gateway-api.sigs.k8s.io und gateway.envoyproxy.io. Nicht erlaubt: Lösungen aus den Kapiteln abschreiben. - Jede Aufgabe zählt nur, wenn das Prüfskript sie mit ✔ meldet.
- Bestanden: mindestens 70 von 100 Punkten und Aufgabe 8 vollständig gelöst.
Frisches Lab? Dann in dieser Reihenfolge (Befehle aus Tag 0, 4 und 7):
~/gw-lab/code/demo/up.sh
helm upgrade --install cert-manager oci://quay.io/jetstack/charts/cert-manager \
--version v1.21.2 -n cert-manager --create-namespace \
--set crds.enabled=true --set config.gatewayAPI.enabled=true --wait
kubectl apply -f ~/gw-lab/code/tag04/lab-ca.yaml
kubectl apply -f ~/gw-lab/code/tag07/payments-api.yamlStart:
mkdir -p ~/gw-lab/pruefung && cd ~/gw-lab/pruefung
export PATH="$HOME/gw-lab/code/demo:$PATH" CA=~/gw-lab/tag04/lab-ca.crt
kubectl config use-context kind-gw-lab
kubectl wait clusterissuer/lab-ca --for=condition=Ready --timeout=10s
kubectl -n payments get deploy payments-apiErwartet:
Switched to context "kind-gw-lab".
clusterissuer.cert-manager.io/lab-ca condition met
NAME READY UP-TO-DATE AVAILABLE AGE
payments-api 1/1 1 1 2d
Teil 1: Praktische Prüfung
Aufgabe 1: Gateway mit Wildcard-TLS (10 Punkte)
Lege das Gateway pruefung in infra an
(GatewayClass eg):
- Listener
http(Port 80), nur Routen aus dem eigenen Namespace. - Listener
https(Port 443) für*.pruefung.gw.localtest.me, Zertifikatpruefung-tlsüber den gateway-shim auslab-ca. Nur Routen aus Namespaces mitgw-lab/teamgleichshopoderpayments.
kubectl -n infra wait gateway/pruefung --for=condition=Programmed --timeout=5s
gw-ip.sh pruefung infra
kubectl -n infra get certificate pruefung-tls -o jsonpath='{.spec.dnsNames}{"\n"}'Erwartet (IP weicht ab):
gateway.gateway.networking.k8s.io/pruefung condition met
172.18.0.9
["*.pruefung.gw.localtest.me"]
Aufgabe 2: HTTP auf HTTPS umleiten (5 Punkte)
Jeder Request auf Port 80 bekommt einen 301 auf dieselbe URL mit
https. Die Route heißt pruefung-redirect und
liegt in infra.
IP=$(gw-ip.sh pruefung infra)
curl -sI --resolve shop.pruefung.gw.localtest.me:80:$IP \
'http://shop.pruefung.gw.localtest.me/x?y=1' | grep -iE '^(HTTP|location)'Erwartet:
HTTP/1.1 301 Moved Permanently
location: https://shop.pruefung.gw.localtest.me/x?y=1
Aufgabe 3: Shop mit Matching und Canary (15 Punkte)
HTTPRoute pruefung-shop in shop für
shop.pruefung.gw.localtest.me:
/v2und alles darunter →shop-v2.- Header
x-canary: always→ immershop-v2. - Alles andere: 90 %
shop-v1, 10 %shop-v2.
Aufgabe 4: API mit Rewrite, Header und Timeout (10 Punkte)
HTTPRoute pruefung-api in shop für
api.pruefung.gw.localtest.me: Alles unter /api
geht ohne das Präfix an shop-v1 (/api/produkte
→ /produkte), jede Antwort trägt
x-pruefung: bestanden, nach 2 s bricht das Gateway ab
(504).
Aufgabe 5: Namespaceübergreifend mit ReferenceGrant (10 Punkte)
Das Payments-Team veröffentlicht
pay.pruefung.gw.localtest.me mit einer HTTPRoute
pruefung-pay im Namespace
payments, die auf den Service shop-v1
in shop zeigt. Die Freigabe heißt pruefung-pay
und gilt nur für genau diesen Service.
Aufgabe 6: Rate Limit (10 Punkte)
BackendTrafficPolicy pruefung-limit an
pruefung-api: höchstens 5 Requests pro Sekunde (lokal, ohne
Redis). Die Policy muss Accepted=True melden.
Aufgabe 7: Basic Auth für /admin (10 Punkte)
https://shop.pruefung.gw.localtest.me/admin nur mit
Benutzer pruefer und Passwort lab-pruef-1234
(Lab-Wert). Eigene Route pruefung-admin in
shop an shop-v1, SecurityPolicy
pruefung-admin, Secret pruefung-users.
Aufgabe 8: Kaputte Route reparieren (15 Punkte, Pflicht)
Ein Kollege hat diese Route angelegt.
https://kaputt.pruefung.gw.localtest.me/ soll
shop-v1 liefern. Repariere nur die Route;
Gateway und Service bleiben, wie sie sind. Es gibt drei Fehler.
cat > kaputt.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: pruefung-kaputt
namespace: shop
spec:
parentRefs:
- name: pruefung
namespace: infra
sectionName: https-shop
hostnames:
- kaputt.gw.localtest.me
rules:
- backendRefs:
- name: shop-v1
port: 8080
EOF
kubectl apply -f kaputt.yaml
conds.sh httproute pruefung-kaputt shopErwartet (gekürzt, kann je nach Version abweichen):
httproute.gateway.networking.k8s.io/pruefung-kaputt created
parent infra/pruefung/https-shop:
Accepted=False (NoMatchingParent): No listeners match this parent ref
...
Notiere zu jedem Fehler die Condition, an der du ihn erkannt hast.
Aufgabe 9: Zwei Envoy-Replikas (5 Punkte)
Das Gateway pruefung läuft mit zwei Envoy-Pods. Nutze
dafür ein EnvoyProxy-Objekt pruefung-proxy in
infra, nicht kubectl scale.
Aufgabe 10: Ingress migrieren (10 Punkte)
Übersetze diesen Ingress mit ingress2gateway (offline)
und bring das Ergebnis an infra/pruefung, Listener
https.
https://legacy.pruefung.gw.localtest.me/alt/x muss bei
shop-v2 als /x ankommen. Die Route heißt
pruefung-legacy. Den Ingress selbst wendest du nicht
an.
cat > legacy-ingress.yaml <<'EOF'
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: legacy
namespace: shop
annotations:
nginx.ingress.kubernetes.io/use-regex: "true"
nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
ingressClassName: nginx
rules:
- host: legacy.pruefung.gw.localtest.me
http:
paths:
- path: /alt(/|$)(.*)
pathType: ImplementationSpecific
backend:
service:
name: shop-v2
port:
number: 80
EOF
ingress2gateway print --providers=ingress-nginx --input-file legacy-ingress.yaml \
-A --no-color > legacy-gw.yaml 2> legacy-warnungen.txt
grep -c 'kind: HTTPRoute' legacy-gw.yamlErwartet:
1
Prüfskript
cat > ~/gw-lab/pruefung/pruefung-check.sh <<'EOF'
#!/usr/bin/env bash
# Anhang B: Prüfskript – zählt Punkte pro Aufgabe
# shellcheck disable=SC2016 # Prüfbefehle stehen in '…' und laufen per eval
set -uo pipefail
CA="${CA:-$HOME/gw-lab/tag04/lab-ca.crt}"
IP=$(gw-ip.sh pruefung infra) || exit 1
D=pruefung.gw.localtest.me
total=0; a8=0
pt() { # pt <punkte> <text> <prüfbefehl>
if eval "$3" >/dev/null 2>&1; then
total=$((total + $1)); printf '✔ %2s %s\n' "$1" "$2"; return 0
fi
printf '✘ 0 %s\n' "$2"; return 1
}
c() { # c <host> [pfad] [curl-Optionen ...]: HTTPS gegen das Prüfungs-Gateway
curl -s --max-time 5 --cacert "$CA" --resolve "$1.$D:443:$IP" "${@:3}" \
"https://$1.$D${2:-/}"
}
svc() { c "$@" | jq -r .service; }
st() { c "$@" -o /dev/null -w '%{http_code}'; }
anteil_v2() { # 200 Requests, shop-v2 muss zwischen 8 und 40 liegen
local n; n=$(for _ in $(seq 200); do svc shop; done | grep -c shop-v2)
[ "$n" -ge 8 ] && [ "$n" -le 40 ]
}
ok_conds() { # alle Conditions aller Parents True (ohne RouteRulesOverlap)
kubectl -n "$1" get httproute "$2" -o json | jq -e '[.status.parents[].conditions[]
| select(.type != "RouteRulesOverlap" and .status != "True")] | length == 0'
}
echo "== A1"
pt 5 "Gateway pruefung Programmed" \
'kubectl -n infra wait gateway/pruefung --for=condition=Programmed --timeout=5s'
pt 5 "Wildcard-Zertifikat aus lab-ca" 'openssl s_client -connect "$IP:443" \
-servername "shop.$D" </dev/null 2>/dev/null | openssl x509 -noout -text \
| grep -q "DNS:\*\.$D"'
echo "== A2"
pt 5 "HTTP -> 301 HTTPS" 'curl -sI --resolve "shop.$D:80:$IP" "http://shop.$D/x" \
| grep -qi "^location: https://shop.$D/x"'
echo "== A3"
pt 5 "/v2 -> shop-v2" '[ "$(svc shop /v2/a)" = shop-v2 ]'
pt 5 "x-canary: always -> shop-v2" '[ "$(svc shop / -H "x-canary: always")" = shop-v2 ]'
pt 5 "Rest 90/10" 'anteil_v2'
echo "== A4"
pt 4 "Rewrite /api/produkte -> /produkte" \
'[ "$(c api /api/produkte | jq -r .path)" = /produkte ]'
pt 3 "Header x-pruefung" \
'c api /api/ -D - -o /dev/null | grep -qi "^x-pruefung: bestanden"'
pt 3 "Timeout 504" '[ "$(st api "/api/x?delay=3s")" = 504 ]'
echo "== A5"
pt 3 "ReferenceGrant auf genau shop-v1" 'kubectl -n shop get referencegrant \
pruefung-pay -o json | jq -e "[.spec.to[]
| select(.kind == \"Service\" and .name == \"shop-v1\")] | length == 1"'
pt 7 "pay -> shop-v1 aus payments" '[ "$(svc pay)" = shop-v1 ] \
&& kubectl -n payments get httproute pruefung-pay'
echo "== A6"
pt 5 "Policy pruefung-limit Accepted" 'kubectl -n shop get backendtrafficpolicy \
pruefung-limit -o json | jq -e ".status.ancestors[0].conditions[]
| select(.type == \"Accepted\" and .status == \"True\")"'
pt 5 "429 bei 30 schnellen Requests" '[ "$(for _ in $(seq 30); do st api /api/;
echo; done | grep -c 429)" -gt 0 ]'
echo "== A7"
pt 5 "/admin ohne Login 401" '[ "$(st shop /admin)" = 401 ]'
pt 5 "/admin mit Login 200" '[ "$(st shop /admin -u pruefer:lab-pruef-1234)" = 200 ]'
echo "== A8 (Pflicht)"
pt 10 "kaputt -> shop-v1" '[ "$(svc kaputt)" = shop-v1 ]' && a8=$((a8 + 1))
pt 5 "pruefung-kaputt ohne False" 'ok_conds shop pruefung-kaputt' && a8=$((a8 + 1))
echo "== A9"
pt 5 "2 Envoy-Replikas über EnvoyProxy" 'kubectl -n infra get envoyproxy \
pruefung-proxy && [ "$(kubectl -n envoy-gateway-system get deploy \
-l gateway.envoyproxy.io/owning-gateway-name=pruefung \
-o jsonpath="{.items[0].status.readyReplicas}")" = 2 ]'
echo "== A10"
pt 10 "legacy /alt/x -> /x bei shop-v2" 'kubectl -n shop get httproute \
pruefung-legacy && [ "$(c legacy /alt/x | jq -r ".path + \" \" + .service")" \
= "/x shop-v2" ]'
echo "== Ergebnis: $total von 100 Punkten"
if [ "$total" -ge 70 ] && [ "$a8" -eq 2 ]; then echo "✔ BESTANDEN"
else echo "✘ NICHT BESTANDEN (70 Punkte und Aufgabe 8 nötig)"; fi
EOF
chmod +x ~/gw-lab/pruefung/pruefung-check.sh
~/gw-lab/pruefung/pruefung-check.shErwartet bei voller Lösung (gekürzt, kann je nach Version abweichen):
== A1
✔ 5 Gateway pruefung Programmed
✔ 5 Wildcard-Zertifikat aus lab-ca
== A2
✔ 5 HTTP -> 301 HTTPS
...
== A10
✔ 10 legacy /alt/x -> /x bei shop-v2
== Ergebnis: 100 von 100 Punkten
✔ BESTANDEN
Das Skript ist idempotent – lass es nach jeder Aufgabe laufen. Die Prüfung von A6 schickt absichtlich mehr als fünf Requests pro Sekunde; direkt danach können einzelne A4-Prüfungen kurz 429 sehen. Dann einfach eine Sekunde warten und neu starten.
Punkte
| Aufgabe | Thema | Punkte | erreicht |
|---|---|---|---|
| 1 | Gateway mit Wildcard-TLS | 10 | |
| 2 | HTTP → HTTPS | 5 | |
| 3 | Matching und Canary | 15 | |
| 4 | Rewrite, Header, Timeout | 10 | |
| 5 | ReferenceGrant | 10 | |
| 6 | Rate Limit | 10 | |
| 7 | Basic Auth | 10 | |
| 8 | Fehlersuche (Pflicht) | 15 | |
| 9 | EnvoyProxy | 5 | |
| 10 | Ingress-Migration | 10 | |
| Summe | 100 |
Aufräumen nach der Prüfung:
kubectl -n infra delete gateway pruefung
kubectl -n infra delete httproute pruefung-redirect
kubectl -n infra delete envoyproxy pruefung-proxy
kubectl -n infra delete secret pruefung-tls
kubectl -n shop delete httproute pruefung-shop pruefung-api pruefung-admin \
pruefung-kaputt pruefung-legacy
kubectl -n shop delete backendtrafficpolicy pruefung-limit
kubectl -n shop delete securitypolicy pruefung-admin
kubectl -n shop delete secret pruefung-users
kubectl -n shop delete referencegrant pruefung-pay
kubectl -n payments delete httproute pruefung-payTeil 2: Kurzfragen
Je 1 Punkt, Bestehensgrenze 18 von 25. Antworte in einem Satz.
- Welche drei Rollen trennt die Gateway API, und welche Ressource gehört zu welcher?
- Was bedeutet eine GatewayClass mit
Accepted=Unknownund ReasonPending? - Worin unterscheiden sich
AcceptedundProgrammedam Gateway? - Wie verknüpfen sich mehrere Einträge unter
matchesund die Felder innerhalb eines Eintrags? - Passt
PathPrefix /v2auf/v2x? Warum (nicht)? - Zwei gleich spezifische Regeln aus zwei Routen beanspruchen denselben Pfad. Wer gewinnt?
- Eine Route hat
ResolvedRefs=False (BackendNotFound). Was sieht der Client? - Wo legst du eine ReferenceGrant an, wenn eine Route in
shopauf einen Service inpaymentszeigt? - Welche Felder braucht ein Listener, damit der cert-manager-gateway-shim ein Zertifikat ausstellt?
- Was unterscheidet
tls.mode: TerminatevonPassthrough, und welche Route-Art gehört zu Passthrough? - Wozu ist
validation.hostnamein einer BackendTLSPolicy da? - Was bedeutet
weight: 0, und warum lässt man ein Backend so in der Route? - Warum ist ein Canary mit Gewichten kein Health-Check?
- Was zählt
retry.attempts: 3genau? - Was unterscheidet
timeouts.requestvontimeouts.backendRequest? - Welche Envoy-Gateway-Policy setzt du für ein Rate Limit, welche für JWT, welche für Client-Timeouts?
- Warum lässt ein lokales Rate Limit von 10/s bei zwei Envoy-Pods mehr als 10 Requests durch?
- Was passiert per Default mit Requests, wenn Redis für das globale Rate Limit ausfällt?
- Warum braucht Cilium-L2 am Envoy-Service
externalTrafficPolicy: Cluster? - Was blockt die ValidatingAdmissionPolicy
safe-upgrades.gateway.networking.k8s.io, und was nicht? - In welcher Reihenfolge upgradest du Envoy Gateway, und warum macht
helm upgradedas nicht allein? - Wie heißt der Envoy-Cluster der ersten Regel der HTTPRoute
shop/shop, und wofür brauchst du den Namen? - Was bedeuten die Response-Flags
UHundRLSE? - Nenne zwei Annotationen, die
ingress2gatewaynicht oder falsch übersetzt. - Was ist ein InferencePool, und wer wählt darin den Pod für einen Request aus?
Lösungsschlüssel
- Infrastruktur-Anbieter/Cluster-Operator: GatewayClass; Plattform-Team: Gateway; App-Teams: Routes (und ListenerSets).
- Kein Controller hat die Klasse übernommen – der
controllerNamepasst zu keiner installierten Implementierung. Accepted: Die Spec ist gültig;Programmed: Die Datenebene ist konfiguriert und hat eine Adresse.- Mehrere
matches-Einträge sind ODER, Bedingungen innerhalb eines Eintrags UND. - Nein:
PathPrefixvergleicht ganze Pfadsegmente,/v2xist ein anderes Segment. - Die ältere Route (
creationTimestamp), bei Gleichstand alphabetisch nachnamespace/name; Envoy Gateway meldetRouteRulesOverlap. - HTTP 500 für die betroffene Regel – die Route ist akzeptiert, ihr Backend nicht.
- Im Ziel-Namespace
payments,fromHTTPRoute ausshop,toService (am besten mitname). protocol: HTTPS,hostname,tls.mode: TerminateundcertificateRefs(Name = Secret) plus die Issuer-Annotation am Gateway.- Terminate entschlüsselt am Gateway (L7 möglich), Passthrough reicht TLS unverändert nach SNI durch – mit TLSRoute.
- Envoy sendet ihn als SNI zum Backend und prüft das Backend-Zertifikat dagegen.
- Das Backend bekommt keinen Traffic, bleibt aber für einen Rollback per Zahlendreher stehen.
- Gewichte verteilen auch auf Backends ohne Endpunkte – deren Anteil endet in 503.
- Drei Wiederholungen, also bis zu vier Versuche insgesamt.
requestbegrenzt die Gesamtzeit bis zur Antwort an den Client inklusive Retries,backendRequestjeden einzelnen Versuch.- BackendTrafficPolicy (Rate Limit), SecurityPolicy (JWT), ClientTrafficPolicy (Client-Timeouts).
- Jeder Envoy-Pod hat seinen eigenen Token-Bucket.
- Sie laufen ohne Limit durch (fail-open); nur mit
rateLimit.failClosed: truegibt es 500. - Sonst kann die IP auf einem Node angekündigt werden, auf dem kein Envoy-Pod läuft, und der Traffic geht verloren.
- Sie blockt CRD-Bundles unter v1.5 und Experimental über Standard; Standard über Experimental lässt sie durch.
- Release Notes, CRDs
(
helm template … | kubectl apply --server-side), Controller, Proxys – Helm installiert CRDs nur beim ersteninstall. httproute/shop/shop/rule/0– das Labelenvoy_cluster_nameist der Routen-Schlüssel in PromQL und im Access Log.UH: kein gesunder Upstream (keine Endpunkte);RLSE: Rate-Limit-Dienst nicht erreichbar.- Zum Beispiel
rewrite-targetmit Capture Groups (fehlt),proxy-read-timeout(anderer Wert), Snippets,auth-url. - Ein Backend-Objekt (
inference.networking.k8s.io/v1) für Modell-Server-Pods; der Endpoint Picker (EPP) wählt perext_procden Pod.
Teil 3: Selbsteinschätzung
| Thema | kann ich | im Lab gemacht |
|---|---|---|
| Ressourcenmodell, Conditions lesen (Tag 1) | [ ] | [ ] |
| Gateway, Listener, Matching (Tag 2) | [ ] | [ ] |
| Filter, Timeouts, Retries (Tag 3) | [ ] | [ ] |
| TLS, cert-manager, Passthrough, BackendTLSPolicy (Tag 4) | [ ] | [ ] |
| Canary und Blue-Green (Tag 5) | [ ] | [ ] |
| GRPCRoute, TCPRoute, UDPRoute (Tag 6) | [ ] | [ ] |
| allowedRoutes, ReferenceGrant, ListenerSet, RBAC (Tag 7) | [ ] | [ ] |
| RKE2 HA auf Proxmox mit Cilium (Tag 8) | [ ] | [ ] |
| LB-IPAM, L2, zwei GatewayClasses, DNS (Tag 9) | [ ] | [ ] |
| Client-, Backend-, Security-Policies (Tag 10) | [ ] | [ ] |
| Metriken, Access Logs, Tracing, Status-Alerts (Tag 11) | [ ] | [ ] |
| HPA, PDB, Drain, Upgrades, Zertifikatsrotation (Tag 12) | [ ] | [ ] |
| Ingress-Migration mit Parallelbetrieb (Tag 13) | [ ] | [ ] |
| Desaster-Drills unter Zeitdruck (Tag 14) | [ ] | [ ] |
Jede Zeile ohne zwei Kreuze: das Kapitel noch einmal durcharbeiten.