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/anhbund ändere Kong nur überkong.yamlundksync(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 .urlErwartet:
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 -1Erwartet:
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/notesErwartet: 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 -1Erwartet:
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
doneErwartet:
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 -1Erwartet:
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 -cErwartet:
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 -1Erwartet:
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 10Prüfblock:
curl -s -o /dev/null -w '%{http_code}\n' $PROXY/hintertuer
deck gateway diff ~/kong-lab/kong/kong.yaml 2>/dev/null | tail -3Erwartet:
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 -1Erwartet (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}'; echoErwartet:
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}
EOFErwartet:
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 -lErwartet: 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
- Warum ist die Admin API in diesem Buch nie an
0.0.0.0gebunden, und wie erreichst du sie trotzdem vom Laptop? - Was unterscheidet
deck file validatevondeck gateway validate? - Warum gewinnt bei
GET /api/v1/notesdie Route mit/api/v1/notesgegen/api, obwohl/apizuerst in der Datei steht? - Zwei Auth-Plugins an einer Route: Was gilt ohne und was mit
anonymous? - Warum braucht das Plugin
jwteinen Consumer, und welche Grenze ergibt sich daraus? - Was passiert mit
rate-limitingundpolicy: clusterin einer Data Plane? - Woran erkennst du, ob eine 404 von Kong oder vom Backend stammt?
- Warum zeigt
/upstreams/notes-up/healthim Hybrid-Modus auf der CP nichts? - Was tut der KIC mit einem
URLRewrite-Filter, und welche Folge hat das? - Welche drei Schritte gehören zu jeder Änderung an
kong.yaml?
Antworten
- 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-restrictionund HTTPS (Tag 5, 8, 10). file validateprüft offline nur die Form der Datei,gateway validatefragt Kongs Schema nach erlaubten Werten (Tag 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).
- Ohne
anonymousmüssen beide erfüllt sein (und), mitanonymousreicht eins (oder), und die ACL entscheidet über den anonymen Consumer (Tag 6). jwtsucht den Schlüssel überissbei einem Consumer. Alle Tokens eines Realms landen beim selben Consumer; den Namen aus dem Token reicht erstjwt-identityweiter (Tag 6, 11).- Die DP hat keine Datenbank und verwirft die ganze neue Konfiguration; sie arbeitet mit der alten weiter (Tag 13, Tag 15).
- An
X-Kong-Response-Latencyund der Meldungno Route matchedbei Kong, anX-Kong-Upstream-Latencyund dem Text des Backends sonst (Tag 1, Tag 15). - Health Checks laufen in der DP, die CP verarbeitet keinen Verkehr; den Zustand zeigen die Metriken der DP (Tag 15).
- Er setzt ihn als
request-transformerum; ein zusätzlicherrequest-transformeran derselben Route wirkt nicht (Tag 14). - 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.