Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang B: Abschlussprüfung

Ziel: Ohne Anleitung zeigen, dass du Kong betreiben kannst: veröffentlichen, absichern, begrenzen, verteilen, Drift finden, sichern und in Kubernetes routen. · Dauer: ca. 120 min · Voraussetzung: Tag 15

Spielregeln

  • Jede Übung beschreibt nur das Ziel. Den Weg findest du selbst; die Tage in Klammern helfen beim Nachschlagen.
  • Jede Übung endet mit einem Prüfblock: einzelne Befehle mit dem, was sie zeigen müssen. Erst wenn alle stimmen, gilt die Übung.
  • Arbeite in ~/kong-lab/anhb und ändere Kong nur über kong.yaml und ksync (Ausnahme: Übung 5).
source ~/kong-lab/setup/env.sh
mkdir -p ~/kong-lab/anhb && cd ~/kong-lab/anhb

Übung 1: Ein Status-Endpunkt

Veröffentliche /healthz von notes-api als GET /api/v1/status, über den Upstream notes-up. Andere Methoden dürfen nicht bei notes-api ankommen. (Tag 2, Tag 9)

Prüfblock:

curl -s $PROXY/api/v1/status; echo
curl -s -X POST $PROXY/api/v1/status | jq -r .url

Erwartet:

ok

http://echo:8080/anything/v1/status

Lösung

cat > status.yaml <<'EOF'
services:
  - name: status
    url: http://notes-up/healthz
    routes:
      - name: status
        paths: [/api/v1/status]
        methods: [GET]
EOF
deck file merge ~/kong-lab/kong/kong.yaml status.yaml -o ~/kong-lab/kong/kong.yaml
ksync 2>/dev/null | tail -1

Erwartet:

  Deleted: 0

Der POST landet auf der Auffang-Route /api aus Tag 2, nicht bei notes-api.

Fortschritt speichern? Kostenlos registrieren

Übung 2: Eine neue Kollegin

Leg die Consumerin carla mit dem Schlüssel lab-key-carla-123 in der Gruppe leser an. (Tag 5)

Prüfblock:

curl -s -H 'apikey: lab-key-carla-123' $PROXY/whoami \
  | jq -r '.headers."X-Consumer-Username"[0]'
curl -s -o /dev/null -w '%{http_code}\n' -X POST -H 'apikey: lab-key-carla-123' \
  -H 'Content-Type: application/json' -d '{"text":"carla"}' \
  --cacert ~/kong-lab/tag10/tls/ca.crt https://localhost:8443/api/v1/notes

Erwartet: carla wird erkannt, darf aber nicht schreiben.

carla
403

Lösung

cat > carla.yaml <<'EOF'
consumers:
  - username: carla
    keyauth_credentials:
      - key: lab-key-carla-123
    acls:
      - group: leser
EOF
deck file merge ~/kong-lab/kong/kong.yaml carla.yaml -o ~/kong-lab/kong/kong.yaml
ksync 2>/dev/null | tail -1

Erwartet:

  Deleted: 0

Fortschritt speichern? Kostenlos registrieren

Übung 3: Ein Limit nur für carla

carla darf /whoami höchstens zweimal pro Minute aufrufen, alle anderen ohne neues Limit. (Tag 4, Tag 8)

Prüfblock:

for k in carla-123 anna-456; do
  for i in 1 2 3; do
    curl -s -o /dev/null -w '%{http_code} ' -H "apikey: lab-key-$k" $PROXY/whoami
  done; echo
done

Erwartet:

200 200 429
200 200 200

Lösung

Ein Plugin am Consumer gilt nur für dessen Anfragen:

deck file add-plugins -s ~/kong-lab/kong/kong.yaml \
  --selector '$.consumers[?(@.username=="carla")]' \
  --config '{"name":"rate-limiting","config":{"minute":2,"policy":"local"}}' \
  -o ~/kong-lab/kong/kong.yaml
ksync 2>/dev/null | tail -1

Erwartet:

  Deleted: 0

Fortschritt speichern? Kostenlos registrieren

Übung 4: Eine Instanz still legen

notes-api-2 soll ab sofort keine Anfragen mehr bekommen, ohne dass du den Container stoppst. (Tag 9)

Prüfblock:

for i in $(seq 1 10); do curl -s $PROXY/api/v1/version; done | sort | uniq -c

Erwartet:

     10 0.2.0

Lösung

U='$.upstreams[?(@.name=="notes-up")].targets'
deck file patch -s ~/kong-lab/kong/kong.yaml \
  --selector "$U[?(@.target==\"notes-api-2:8080\")]" \
  --value 'weight:0' -o ~/kong-lab/kong/kong.yaml
ksync 2>/dev/null | tail -1

Erwartet:

  Deleted: 0

Gewicht 0 nimmt ein Target aus der Verteilung, Kong prüft es aber weiter. So legst du eine Instanz vor einer Wartung still, ohne dass ein Client es merkt.

Fortschritt speichern? Kostenlos registrieren

Übung 5: Die Hintertür

Jemand hat über die Admin API einen Service angelegt (das ist die Ausnahme von der Regel: Diesen Block führt die Prüferin aus). Finde ihn und entferne ihn so, dass kong.yaml die Wahrheit bleibt. (Tag 7)

curl -s -o /dev/null -X POST $ADMIN/services -d name=hintertuer \
  -d url=http://echo:8080/anything
curl -s -o /dev/null -X POST $ADMIN/services/hintertuer/routes -d 'paths[]=/hintertuer'
sleep 10

Prüfblock:

curl -s -o /dev/null -w '%{http_code}\n' $PROXY/hintertuer
deck gateway diff ~/kong-lab/kong/kong.yaml 2>/dev/null | tail -3

Erwartet:

404
  Created: 0
  Updated: 0
  Deleted: 0

Lösung

deck gateway diff ~/kong-lab/kong/kong.yaml 2>/dev/null | grep -E '^(creating|deleting)'
ksync 2>/dev/null | tail -1

Erwartet (gekürzt):

deleting route 762f5687-…
deleting service hintertuer
  Deleted: 2

Fortschritt speichern? Kostenlos registrieren

Übung 6: Version in Kubernetes

Veröffentliche in k3s GET /api/v1/version (genau dieser Pfad) auf /version von notes-api, mit der Gateway API. (Tag 14)

Prüfblock (in der VM k3s):

curl -s http://localhost/api/v1/version
kubectl -n notes get httproute version \
  -o jsonpath='{.status.parents[0].conditions[?(@.type=="Accepted")].status}'; echo

Erwartet:

0.2.0
True

Lösung

cat <<'EOF' | kubectl apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: version
  namespace: notes
spec:
  parentRefs:
    - {name: kong, namespace: kong}
  rules:
    - matches:
        - path: {type: Exact, value: /api/v1/version}
          method: GET
      filters:
        - type: URLRewrite
          urlRewrite:
            path: {type: ReplaceFullPath, replaceFullPath: /version}
      backendRefs:
        - {name: notes-api, port: 8080}
EOF

Erwartet:

httproute.gateway.networking.k8s.io/version created

Exact statt PathPrefix, ReplaceFullPath statt ReplacePrefixMatch: Der ganze Pfad wird ersetzt.

Fortschritt speichern? Kostenlos registrieren

Übung 7: Sichern und festhalten

Sichere die Datenbank der Control Plane nach ~/kong-lab/anhb/pruefung.sql.gz und committe deinen Stand. (Tag 3, Tag 7)

Prüfblock (auf der VM kong):

zcat ~/kong-lab/anhb/pruefung.sql.gz | grep -c '^COPY public\.'
zcat ~/kong-lab/anhb/pruefung.sql.gz | grep -c 'carla'
git -C ~/kong-lab/kong status --short | wc -l

Erwartet: viele Tabellen, carla ist in der Sicherung, nichts Uncommittetes.

35
2
0

Lösung

docker compose -f ~/kong-lab/kong/compose.yaml exec -T kong-db \
  pg_dump -U kong -d kong | gzip > ~/kong-lab/anhb/pruefung.sql.gz
cd ~/kong-lab/kong && git add kong.yaml && git commit -qm "Abschlussprüfung"

Fortschritt speichern? Kostenlos registrieren

Wissenstest

  1. Warum ist die Admin API in diesem Buch nie an 0.0.0.0 gebunden, und wie erreichst du sie trotzdem vom Laptop?
  2. Was unterscheidet deck file validate von deck gateway validate?
  3. Warum gewinnt bei GET /api/v1/notes die Route mit /api/v1/notes gegen /api, obwohl /api zuerst in der Datei steht?
  4. Zwei Auth-Plugins an einer Route: Was gilt ohne und was mit anonymous?
  5. Warum braucht das Plugin jwt einen Consumer, und welche Grenze ergibt sich daraus?
  6. Was passiert mit rate-limiting und policy: cluster in einer Data Plane?
  7. Woran erkennst du, ob eine 404 von Kong oder vom Backend stammt?
  8. Warum zeigt /upstreams/notes-up/health im Hybrid-Modus auf der CP nichts?
  9. Was tut der KIC mit einem URLRewrite-Filter, und welche Folge hat das?
  10. Welche drei Schritte gehören zu jeder Änderung an kong.yaml?

Antworten

  1. Wer die Admin API erreicht, kann alles umkonfigurieren und Schlüssel lesen; OSS kennt dort keine Anmeldung. Zugang per SSH-Tunnel (Tag 1) oder über Kong selbst mit basic-auth, acl, ip-restriction und HTTPS (Tag 5, 8, 10).
  2. file validate prüft offline nur die Form der Datei, gateway validate fragt Kongs Schema nach erlaubten Werten (Tag 3).
  3. Kong wählt die genaueste Route: mehr Bedingungen und der längere Präfix gewinnen, die Reihenfolge in der Datei spielt keine Rolle (Tag 2).
  4. Ohne anonymous müssen beide erfüllt sein (und), mit anonymous reicht eins (oder), und die ACL entscheidet über den anonymen Consumer (Tag 6).
  5. jwt sucht den Schlüssel über iss bei einem Consumer. Alle Tokens eines Realms landen beim selben Consumer; den Namen aus dem Token reicht erst jwt-identity weiter (Tag 6, 11).
  6. Die DP hat keine Datenbank und verwirft die ganze neue Konfiguration; sie arbeitet mit der alten weiter (Tag 13, Tag 15).
  7. An X-Kong-Response-Latency und der Meldung no Route matched bei Kong, an X-Kong-Upstream-Latency und dem Text des Backends sonst (Tag 1, Tag 15).
  8. Health Checks laufen in der DP, die CP verarbeitet keinen Verkehr; den Zustand zeigen die Metriken der DP (Tag 15).
  9. Er setzt ihn als request-transformer um; ein zusätzlicher request-transformer an derselben Route wirkt nicht (Tag 14).
  10. Prüfen (deck gateway validate), vergleichen (deck gateway diff), anwenden und committen (Tag 3, Tag 7).

Wie geht es weiter?

  • Keycloak tiefer: Realms, Clients, LDAP und Betrieb im Buch „Keycloak zum Anfassen”.
  • Gateway API mit Envoy: dieselben Konzepte mit einem anderen Gateway im Buch „Gateway API zum Anfassen”.
  • Kubernetes: Datenbank als StatefulSet statt Speicherbetrieb, Helm-Charts, RKE2 im Buch „Kubernetes zum Anfassen”.
  • Weiter mit Kong: Konnect als verwaltete Control Plane, Kong Operator, eigene Plugins mit Pongo testen.