Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  1. Tippen, nicht kopieren. Jeder Befehl einmal selbst.
  2. Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
  3. 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.
  4. Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
  5. Challenge allein lösen. Erst den Hinweis, dann die Lösung.
  6. Lab-Werte bleiben im Lab. lab-api-key-123 und die anderen lab-…-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.