Zum Inhalt springen
Trainingslager IT-Trainingslager

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-lab auf dem Laptop, Stand nach Tag 7 (Envoy Gateway v1.9.2, cert-manager mit ClusterIssuer lab-ca, payments-api aus Tag 7). cloud-provider-kind läuft im zweiten Terminal.
  • Alles kommt an ein neues Gateway infra/pruefung mit 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.yaml

Start:

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-api

Erwartet:

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, Zertifikat pruefung-tls über den gateway-shim aus lab-ca. Nur Routen aus Namespaces mit gw-lab/team gleich shop oder payments.
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:

  • /v2 und alles darunter → shop-v2.
  • Header x-canary: always → immer shop-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 shop

Erwartet (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.yaml

Erwartet:

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.sh

Erwartet 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-pay

Teil 2: Kurzfragen

Je 1 Punkt, Bestehensgrenze 18 von 25. Antworte in einem Satz.

  1. Welche drei Rollen trennt die Gateway API, und welche Ressource gehört zu welcher?
  2. Was bedeutet eine GatewayClass mit Accepted=Unknown und Reason Pending?
  3. Worin unterscheiden sich Accepted und Programmed am Gateway?
  4. Wie verknüpfen sich mehrere Einträge unter matches und die Felder innerhalb eines Eintrags?
  5. Passt PathPrefix /v2 auf /v2x? Warum (nicht)?
  6. Zwei gleich spezifische Regeln aus zwei Routen beanspruchen denselben Pfad. Wer gewinnt?
  7. Eine Route hat ResolvedRefs=False (BackendNotFound). Was sieht der Client?
  8. Wo legst du eine ReferenceGrant an, wenn eine Route in shop auf einen Service in payments zeigt?
  9. Welche Felder braucht ein Listener, damit der cert-manager-gateway-shim ein Zertifikat ausstellt?
  10. Was unterscheidet tls.mode: Terminate von Passthrough, und welche Route-Art gehört zu Passthrough?
  11. Wozu ist validation.hostname in einer BackendTLSPolicy da?
  12. Was bedeutet weight: 0, und warum lässt man ein Backend so in der Route?
  13. Warum ist ein Canary mit Gewichten kein Health-Check?
  14. Was zählt retry.attempts: 3 genau?
  15. Was unterscheidet timeouts.request von timeouts.backendRequest?
  16. Welche Envoy-Gateway-Policy setzt du für ein Rate Limit, welche für JWT, welche für Client-Timeouts?
  17. Warum lässt ein lokales Rate Limit von 10/s bei zwei Envoy-Pods mehr als 10 Requests durch?
  18. Was passiert per Default mit Requests, wenn Redis für das globale Rate Limit ausfällt?
  19. Warum braucht Cilium-L2 am Envoy-Service externalTrafficPolicy: Cluster?
  20. Was blockt die ValidatingAdmissionPolicy safe-upgrades.gateway.networking.k8s.io, und was nicht?
  21. In welcher Reihenfolge upgradest du Envoy Gateway, und warum macht helm upgrade das nicht allein?
  22. Wie heißt der Envoy-Cluster der ersten Regel der HTTPRoute shop/shop, und wofür brauchst du den Namen?
  23. Was bedeuten die Response-Flags UH und RLSE?
  24. Nenne zwei Annotationen, die ingress2gateway nicht oder falsch übersetzt.
  25. Was ist ein InferencePool, und wer wählt darin den Pod für einen Request aus?

Lösungsschlüssel

  1. Infrastruktur-Anbieter/Cluster-Operator: GatewayClass; Plattform-Team: Gateway; App-Teams: Routes (und ListenerSets).
  2. Kein Controller hat die Klasse übernommen – der controllerName passt zu keiner installierten Implementierung.
  3. Accepted: Die Spec ist gültig; Programmed: Die Datenebene ist konfiguriert und hat eine Adresse.
  4. Mehrere matches-Einträge sind ODER, Bedingungen innerhalb eines Eintrags UND.
  5. Nein: PathPrefix vergleicht ganze Pfadsegmente, /v2x ist ein anderes Segment.
  6. Die ältere Route (creationTimestamp), bei Gleichstand alphabetisch nach namespace/name; Envoy Gateway meldet RouteRulesOverlap.
  7. HTTP 500 für die betroffene Regel – die Route ist akzeptiert, ihr Backend nicht.
  8. Im Ziel-Namespace payments, from HTTPRoute aus shop, to Service (am besten mit name).
  9. protocol: HTTPS, hostname, tls.mode: Terminate und certificateRefs (Name = Secret) plus die Issuer-Annotation am Gateway.
  10. Terminate entschlüsselt am Gateway (L7 möglich), Passthrough reicht TLS unverändert nach SNI durch – mit TLSRoute.
  11. Envoy sendet ihn als SNI zum Backend und prüft das Backend-Zertifikat dagegen.
  12. Das Backend bekommt keinen Traffic, bleibt aber für einen Rollback per Zahlendreher stehen.
  13. Gewichte verteilen auch auf Backends ohne Endpunkte – deren Anteil endet in 503.
  14. Drei Wiederholungen, also bis zu vier Versuche insgesamt.
  15. request begrenzt die Gesamtzeit bis zur Antwort an den Client inklusive Retries, backendRequest jeden einzelnen Versuch.
  16. BackendTrafficPolicy (Rate Limit), SecurityPolicy (JWT), ClientTrafficPolicy (Client-Timeouts).
  17. Jeder Envoy-Pod hat seinen eigenen Token-Bucket.
  18. Sie laufen ohne Limit durch (fail-open); nur mit rateLimit.failClosed: true gibt es 500.
  19. Sonst kann die IP auf einem Node angekündigt werden, auf dem kein Envoy-Pod läuft, und der Traffic geht verloren.
  20. Sie blockt CRD-Bundles unter v1.5 und Experimental über Standard; Standard über Experimental lässt sie durch.
  21. Release Notes, CRDs (helm template … | kubectl apply --server-side), Controller, Proxys – Helm installiert CRDs nur beim ersten install.
  22. httproute/shop/shop/rule/0 – das Label envoy_cluster_name ist der Routen-Schlüssel in PromQL und im Access Log.
  23. UH: kein gesunder Upstream (keine Endpunkte); RLSE: Rate-Limit-Dienst nicht erreichbar.
  24. Zum Beispiel rewrite-target mit Capture Groups (fehlt), proxy-read-timeout (anderer Wert), Snippets, auth-url.
  25. Ein Backend-Objekt (inference.networking.k8s.io/v1) für Modell-Server-Pods; der Endpoint Picker (EPP) wählt per ext_proc den 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.