Vorwort
Wenig lesen, viel tippen. In den Docker-Büchern ist die Anwendung
notes entstanden, mit einer kleinen API in Go. Jetzt
bekommt sie ein Gateway: eine Tür, durch die jede Anfrage muss, die
prüft, wer anklopft, wie oft, über welchen Weg, und die alles
mitschreibt.
Dieses Gateway heißt Kong. Du lernst es von unten nach oben: erst ohne Datenbank mit einer einzigen YAML-Datei, dann mit decK aus Git, mit Plugins für Schlüssel, JWT und Rate Limits, mit Postgres, Load Balancing und TLS. Du schreibst ein eigenes Plugin in Lua, beobachtest Kong mit Prometheus und Grafana, teilst es in Control Plane und Data Plane und setzt es am Ende als Ingress Controller in Kubernetes ein.
Das Buch arbeitet mit Kong Gateway OSS 3.9, der freien Ausgabe unter Apache-Lizenz. Alles lässt sich ohne Konto und ohne Lizenz nachbauen. Was die Enterprise-Ausgabe und Konnect zusätzlich können, zeigen die Enterprise-Notizen und Tag 14.
Das Buch richtet sich an Backend-, Platform- und Ops-Leute, die Docker und HTTP sicher beherrschen und APIs zentral veröffentlichen, absichern und beobachten wollen.
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.
- Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-api-key-123,lab-key-anna-123,lab-db-pw-123und alle anderenlab-…-Werte sind Übungsdaten. Echte Tokens gibst du nie aus, auch im Labor nicht.
Achtung: Alle Ausgaben stammen aus echten Testläufen. IDs, Zeiten und IP-Adressen werden bei dir abweichen. Entscheidend ist, was passiert.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle mit erwarteter Ausgabe |
| Kontrollpunkt | Einzelne Prüfbefehle: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Produktion anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| 1 – Kong kennenlernen | 0 | Das Trainingsgelände |
| 1 | Erster Start ohne Datenbank | |
| 2 | Services und Routes | |
| 3 | Deklarativ mit decK | |
| 4 | Plugins | |
| 2 – Absichern und betreiben | 5 | Consumers und Schlüssel |
| 6 | JWT mit Keycloak | |
| 7 | Kong mit Postgres | |
| 8 | Rate Limiting und Schutz | |
| 9 | Upstreams und Load Balancing | |
| 10 | TLS | |
| 11 | Ein eigenes Plugin in Lua | |
| 12 | Beobachten | |
| 3 – Verteilt und auf Kubernetes | 13 | Hybrid-Modus |
| 14 | Kong Ingress Controller | |
| Wettkampf | 15 | Desaster-Drills |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Labor
Gearbeitet wird auf einer Ubuntu-24.04-VM kong mit 2
CPUs und 4 GB RAM, die du per Multipass startest, und zwar per SSH auf
der VM. Für Tag 13 kommt eine kleine zweite VM dp dazu, für
Tag 14 eine VM k3s. Jede andere Ubuntu-VM mit SSH,
sudo und Internetzugang tut es auch.
Die getesteten Versionen: Kong Gateway OSS 3.9.4, decK 1.69.0, Keycloak 26.8.1, Postgres 18.6, Kong Ingress Controller 3.5.14 und k3s v1.36.5.
Wo dieses Buch einen Bereich nur anreißt, gehen die Schwesterbücher in die Tiefe: „Docker Compose zum Anfassen” für das Backend, „Kubernetes zum Anfassen” für Tag 14, „Gateway API zum Anfassen” für Routing mit Envoy Gateway.
Los geht’s.