Zum Inhalt springen
Trainingslager IT-Trainingslager

Vorwort

GitOps klingt nach einem großen Konzept, ist aber eine einfache Regel: Was im Cluster laufen soll, steht in Git, und ein Programm im Cluster sorgt dafür, dass es auch so bleibt. Niemand ruft mehr kubectl apply von seinem Laptop auf. Wer etwas ändern will, macht einen Commit. Argo CD ist das verbreitetste Programm dafür, mit einer Weboberfläche, die zeigt, was läuft, was abweicht und warum.

Dieses Buch fängt ohne Argo CD an. In Tag 0 startest du notes-api von Hand und siehst, wie schnell niemand mehr weiß, was im Cluster eigentlich läuft. Danach übernimmt Argo CD Schritt für Schritt: die erste Application, Sync-Policies, Reihenfolge mit Hooks, Helm und Kustomize, App of Apps, ApplicationSets, Projekte und Rechte, verschlüsselte Secrets, ein zweiter Cluster, automatische Image-Updates, Benachrichtigungen, Canary und Blue-Green mit Argo Rollouts und am Ende ein echtes Upgrade. Als roter Faden läuft notes-api mit Postgres.

Jede Ausgabe in diesem Buch stammt aus einem echten Lauf auf zwei Test-VMs. Viele Kapitel zeigen, was beim Testen schiefging: der Hook, der auf ein Secret wartet, das es noch nicht gibt, das ApplicationSet, das beim Löschen eines Ordners still die Datenbank mitnimmt, oder der Image Updater, der mit dem ApplicationSet um dasselbe Feld kämpft. Diese Stellen sind mit Ausprobiert markiert.

Für wen dieses Buch ist

Für Plattform-Teams, die Kubernetes-Cluster mit Git statt mit Skripten betreiben wollen, für Entwickler, die wissen wollen, was nach ihrem Merge passiert, und für alle, die Argo CD schon nutzen, aber nie unter die Haube geschaut haben. Du solltest Kubernetes-Grundlagen kennen: Pods, Deployments, Services, Namespaces und kubectl. Git solltest du auf der Kommandozeile bedienen können. Das Buch braucht kein anderes Buch der Reihe. Wer „Flux zum Anfassen“ kennt, findet in Tag 14 einen Vergleich.

Wie das Buch aufgebaut ist

16 Trainingstage, jeder mit derselben Struktur:

  • Ziel und Briefing: worum es geht, in wenigen Punkten.
  • Drills: Schritt für Schritt, jeder Befehl mit der erwarteten Ausgabe.
  • Kontrollpunkt: einzelne Befehle, die zeigen, ob du am Ziel bist.
  • Challenge: eine Aufgabe mit Hinweis und Lösung.
  • Enterprise-Notiz: was im Betrieb anders ist als im Lab.

Tag 0 bis 3 legen das Fundament: Gelände, Installation, die erste Application, Sync-Policies. Tag 4 bis 8 sind die Werkzeuge für echte Anwendungen: Hooks, Helm, Kustomize, App of Apps und ApplicationSets. Tag 9 bis 11 machen Argo CD mandantenfähig: Projekte, Secrets und mehrere Cluster. Tag 12 und 13 automatisieren die Auslieferung mit Image Updater, Notifications und Rollouts. Tag 14 ist Betrieb und Upgrade, Tag 15 ein Wettkampf aus fünf Störungen. Am Ende stehen ein Spickzettel und eine Abschlussprüfung.

Was du brauchst

  • Zwei Linux-VMs mit Ubuntu 24.04: argo mit 4 vCPUs, 8 GB RAM und 40 GB Platte, prod mit 2 vCPUs, 4 GB RAM und 30 GB Platte, beide im selben Netz. prod brauchst du erst ab Tag 11.
  • Internetzugang für beide.
  • Ein Konto bei GitHub für das Fleet-Repo.
  • Etwa 20 Stunden, verteilt auf so viele Tage, wie du möchtest.

Versionen

Getestet mit Ubuntu 24.04, k3s v1.37.2+k3s1, Argo CD 3.5.7 und 3.6.1, Helm 4.3.2, Kustomize 5.8.1 (in Argo CD), Argo CD Image Updater 1.5.0, Argo Rollouts 1.10.2, SOPS 3.13.3, age 1.3.2 und KSOPS 4.5.1. Neuere Versionen verhalten sich meist gleich, die Ausgaben können aber abweichen. Im Zweifel hilft die Dokumentation unter argo-cd.readthedocs.io.

Begleitcode

Alle Dateien und Lösungen liegen auf GitHub: github.com/thomaszachmann/argocd-zum-anfassen. In loesung/tagNN findest du den Stand des Fleet-Repos am Ende jedes Tages, in wettkampf/ die Reparaturen der Runden aus Tag 15.

Viel Spaß im Trainingslager.

Thomas Zachmann