Vorwort
Wenig lesen, viel tippen. Ein Entwicklerteam will eine kleine API mit Datenbank betreiben. Dafür braucht es ein Deployment, einen Service, ein Secret, ein StatefulSet, ein Volume, eine NetworkPolicy und am besten noch Checks, die melden, wenn etwas klemmt. Das sind sieben Objekte mit zusammen über 200 Zeilen YAML. Das Team will davon nichts wissen, sondern einfach sagen: „Ich hätte gern eine Notes-App mit zwei Replikas.“
Genau das baust du in diesem Buch. kro (Kube
Resource Orchestrator) ist ein Controller für Kubernetes. Du beschreibst
darin eine eigene API, etwa NotesApp, und legst fest,
welche Objekte bei jeder Instanz entstehen und wie ihre Werte
zusammenhängen. kro erzeugt daraus eine CRD, prüft jeden Ausdruck schon
beim Anlegen und hält danach alle Objekte in der richtigen Reihenfolge
am Leben. Go-Code, ein eigenes Operator-Projekt oder Templates brauchst
du dafür nicht.
Der rote Faden ist notes-api, die kleine Notiz-API
aus den Schwesterbüchern. An Tag 4 bekommt sie ihre eigene API
NotesApp. Danach wächst sie Tag für Tag: Status und
Readiness, Postgres mit geschütztem Volume, optionale NetworkPolicy,
Checks pro Pfad, zentrale Vorgaben der Plattform, eine Flotte mit
mehreren Umgebungen, Rechte für Teams und am Ende GitOps.
Das Buch richtet sich an Platform-Leute, Admins und Entwickler, die
Kubernetes und kubectl kennen und ihren Teams eigene,
einfache APIs anbieten 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.
- Erst die RGD, dann die Instanz. Jede Änderung an
einer ResourceGraphDefinition prüfst du mit
kubectl get rgd, bevor du Instanzen anlegst. Die meisten Fehler zeigt kro schon dort. - 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-123und die anderenlab-…-Werte sind Übungsdaten. Echte Geheimnisse haben in diesem Buch nichts zu suchen.
Achtung: Alle Ausgaben stammen aus echten Testläufen. Zeiten, IDs, Hashes und Pod-Namen werden bei dir abweichen. Entscheidend ist, was passiert.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle und Dateien mit erwarteter Ausgabe |
| Kontrollpunkt | Einzelne Prüfbefehle: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was im Betrieb anders ist |
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| 1 – Grundlagen | 0 | Das Trainingsgelände |
| 1 | kro installieren, erste RGD | |
| 2 | SimpleSchema | |
| 3 | CEL-Ausdrücke | |
| 2 – Die NotesApp | 4 | Mehrere Ressourcen, ein Graph |
| 5 | Status und Readiness | |
| 6 | Postgres und die Deletion Policy | |
| 7 | Bedingungen mit includeWhen | |
| 8 | Collections mit forEach | |
| 9 | Externe Referenzen | |
| 10 | RGD-Chaining: die Flotte | |
| 3 – Betrieb | 11 | Lebenszyklus und Revisionen |
| 12 | Rechte, Feature Gates, Metriken | |
| 13 | kro, Helm, Kustomize oder Operator? | |
| 14 | GitOps, Upgrade und Ausblick | |
| Wettkampf | 15 | Fünf Störungen |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Labor
Du arbeitest per SSH auf einer Ubuntu-24.04-VM kro mit 2
CPUs und 4 GB RAM. Die startest du mit Multipass, es tut aber auch jede
andere Linux-VM mit sudo und Internetzugang. Darauf laufen
k3s, kro und alle Instanzen. Der Laptop braucht nur SSH und
curl.
Die getesteten Versionen: k3s 1.37.2, Helm 4.3.1, kro 0.10.0, notes-api 0.5.1 und Postgres 18.6.
Den Begleitcode findest du unter
https://github.com/thomaszachmann/kro-zum-anfassen. Tag 0
holt ihn per git clone. Er enthält zu jedem Tag die
fertigen Dateien in loesung/ und die kaputten Dateien für
den Wettkampf in wettkampf/. Schreiben sollst du die
Dateien selbst. Die Lösungen sind zum Vergleichen da.
Wo dieses Buch einen Bereich nur anreißt, gehen die Schwesterbücher in die Tiefe: „Kubernetes zum Anfassen“ für den Cluster, „Kubernetes-Operatoren zum Anfassen“ für eigene Controller in Go, „Kyverno und NetworkPolicies zum Anfassen“ für Richtlinien.
Los geht’s.