Zum Inhalt springen
Trainingslager IT-Trainingslager

Vorwort

Ein Helm-Chart zu benutzen ist einfach: helm install, fertig. Ein Chart zu schreiben, das in drei Umgebungen gleich zuverlässig läuft, das ein Kollege in zwei Jahren noch versteht, das sich prüfen, signieren und per GitOps ausrollen lässt – das ist Handwerk. Und es zeigt sich meist erst im Betrieb: wenn ein default die gewollte 0 verschluckt, ein Hook vor der Datenbank startet, --reuse-values den neuen Standard ignoriert, ein Upgrade an einem unveränderlichen Selektor scheitert und dabei den Service schon umgebogen hat, oder ein hart abgebrochener CI-Lauf den Release sperrt. Dieses Buch bereitet dich auf genau diese Momente vor – nicht mit Folien, sondern im Terminal.

Du baust über 20 Tage ein eigenes Chart notes auf: erst ein statisches Deployment, dann Werte, Templates, Bausteine, Schema, ein Datenbank-Subchart, ein Library Chart, Hooks, Tests und CRDs. Danach lieferst du es aus – per OCI-Registry, signiert, geprüft von Lint, kubeconform und Unit-Tests, ausgerollt von einer Pipeline, von Flux und von Argo CD – und reparierst, was dabei kaputtgeht. Das Messgerät des Buchs ist helm template: Jede Funktion beginnt mit einem Rendering vorher und endet mit einem Rendering oder einem Blick in den Cluster nachher. Was du nicht nachweisen kannst, hast du nicht gebaut.

Das Buch richtet sich an Plattform- und DevOps-Engineers mit Kubernetes-Grundlagen: Du solltest Deployments, Services, ConfigMaps, Secrets und StatefulSets kennen, YAML lesen und kubectl bedienen können. Ein Helm-Chart installiert zu haben, schadet nicht; selbst geschrieben haben musst du noch keines.

So funktioniert das Buch

  • Ein Tag, ein Thema. Jeder Tag hat ein Ziel, eine Zeitangabe, ein kurzes Briefing und 5–8 Drills. Du tippst jeden Befehl selbst und vergleichst mit „Erwartet“.
  • Vorher, ändern, nachher. Jede Chart-Datei steht beim ersten Mal vollständig da (per Heredoc), danach nur die Änderung als ganze Datei oder als sed/yq. Die erste Zeile jeder Datei sagt, von welchem Tag sie stammt.
  • Kein Hilfsskript. Jeder Schritt steht als einzelner Befehl da, auch der Kontrollpunkt am Ende jedes Tages.
  • Speed-Drills am Ende jedes Tages: kleine Aufgaben mit Zeitziel.
  • Kontrollpunkt, Challenge, Interview-Notiz, Enterprise-Notiz schließen jeden Tag ab. Der Kontrollpunkt prüft mit einzelnen Befehlen, ob dein Labor im erwarteten Zustand ist – die nächsten Tage bauen darauf auf. Die Challenge ist eine Aufgabe ohne Anleitung, mit Hinweis und Lösung. Die Interview-Notiz sammelt Fragen aus Vorstellungsgespräch und Bereitschaftsdienst samt Kernantwort, die Enterprise-Notiz sagt, was in Produktion anders ist als im Labor.
  • Ein Chart durch alle Tage: notes für die Go-API notes-api mit eigenem PostgreSQL-Subchart, dazu der kleine Dienst helper (go-httpbin) auf Basis des Library Charts plattform. Der Release notes/notes ist dein „Produktions“-Release und bleibt grün. Tage, die etwas kaputt machen, arbeiten in Wegwerf-Releases im Namespace tagNN.
  • Ein Repo: Das Chart wächst in ~/helm/charts unter Git, ein Commit pro Tag – so siehst du jederzeit, was sich zwischen zwei Tagen geändert hat.

Zum Schluss:

  • Wettkampf (Tag 20): ein kaputtes Chart samt Release, das du unter Zeitdruck in acht Runden reparierst.
  • Anhang A ist der Spickzettel mit einer Tabelle der Fehlerbilder, Anhang B die Abschlussprüfung: ein eigenes Chart vom ersten Template bis zur signierten Auslieferung, dazu Betrieb und Fehlersuche.

Die Tage im Überblick

Tag Thema Dauer
0 Trainingsgelände: k3s, Helm 4, kubeconfig, Kontext-Falle ca. 45 min
1 Der erste Release: Repo, zot installieren, Upgrade, Rollback ca. 60 min
2 Das eigene Chart: Aufbau, Chart.yaml, Paket, SemVer ca. 45 min
3 Values und Vorrang: -f, --set, --reuse-values & Co. ca. 60 min
4 Eingebaute Objekte, .Capabilities, Template-Grundlagen ca. 45 min
5 Whitespace, if/with/range, Scope, optionaler Ingress ca. 75 min
6 Bausteine: define, include, _helpers.tpl ca. 45 min
7 Sprig, required, tpl, lookup, Prüfsummen ca. 60 min
8 Dateien, existingSecret, values.schema.json ca. 60 min
9 Dependencies und das Subchart postgres ca. 60 min
10 Library Charts: plattform und helper ca. 60 min
11 Hooks und Chart-Tests ca. 60 min
12 CRDs im Chart und im eigenen CRD-Chart ca. 45 min
13 Sicher ausrollen: warten, zurückrollen, Release-Secrets ca. 75 min
14 Drei-Wege-Merge, Server-Side Apply, Migration Helm 3 → 4 ca. 75 min
15 OCI-Registries: zot mit Passwort, Push, Digest ca. 75 min
16 Signieren (GPG, cosign), fremde Charts spiegeln, Geheimnisse ca. 75 min
17 Lint, kubeconform, trivy, pluto, helm-unittest ca. 75 min
18 CI und GitOps: chart-testing, Pipeline, Flux, Argo CD, Kustomize ca. 90 min
19 Fehlersuche: Sperren, unveränderliche Felder, Besitz, alte APIs ca. 90 min
20 Wettkampf: das kaputte Chart ca. 120 min

Zeit: Tag 0 bis 19 summieren sich auf gut 21 Stunden (1275 Minuten), der Wettkampf und die Abschlussprüfung kommen mit je zwei Stunden dazu – insgesamt gut 25 Stunden. Bei einem Trainingstag pro Abend und fünf Abenden pro Woche bist du in gut vier Wochen durch.

Die Reihenfolge ist kein Zufall: Jeder Tag baut auf dem Chart-Stand des Vortags auf. Ab Tag 9 hat notes eine eigene Datenbank, ab Tag 10 kommen Namen und Labels aus der Bibliothek, ab Tag 15 die Abhängigkeiten aus zot, und ab Tag 16 liegen die Signierschlüssel bereit, die Tag 18, 20 und die Prüfung brauchen.

Das Trainingsgelände

Das ganze Buch läuft auf einer VM, Benutzer ubuntu, Arbeitsordner ~/helm/tagNN/:

Rolle Aufgabe IP im Buch Im Labor
prod k3s-Single-Node, zot, Arbeitsplatz 172.16.0.123 2 vCPU, 3,8 GiB RAM, kein Swap
  • k3s v1.37.2+k3s1 ohne metrics-server, mit Traefik als Ingress und local-path als StorageClass. Tag 0 installiert alles; Helm kommt als Binärdatei mit Prüfsumme, nie per Installationsskript.
  • zot läuft als OCI-Registry im Cluster (NodePort 30500) – installiert in Tag 1 aus dem offiziellen Chart, ab Tag 15 mit Passwort.
  • Knapp gerechnet: Nach k3s, zot und notes bleiben gut 2 GiB frei. Flux und Argo CD (Tag 18) laufen deshalb nacheinander, nie gleichzeitig. Wer eine VM mit 4 GB nur für dieses Buch hat, kommt hin; mit 8 GB wird es entspannt. Kleiner ist nicht getestet.
  • Auf der Labor-VM liefen nebenher ein S3-Speicher (RustFS, Port 9000) und ein PostgreSQL auf 127.0.0.1:5432 aus einem anderen Buch. Das Buch fasst sie nicht an und vergibt keine Ports, die mit ihnen kollidieren – auf deiner VM brauchst du sie nicht.

Ehrlich gesagt, was die Tage voraussetzen:

  • Internetzugang der VM für Images (ghcr.io, docker.io, quay.io), Werkzeug-Downloads von GitHub und das zot-Chart-Repository.
  • Tag 14–18 laden Werkzeuge von den offiziellen Release-Seiten nach: Helm 3 (zum Vergleich), helm-diff, cosign, sops, age, helm-secrets, kubeconform, trivy, pluto, helm-unittest, chart-testing, Flux und Argo CD. Jede Binärdatei und jedes Plugin wird gegen die veröffentlichte Prüfsumme bzw. Signatur geprüft; das Argo-CD-Manifest kommt ohne Prüfsumme vom Release-Tag.
  • Tag 18: Für die Screenshots der Argo-CD-Oberfläche einen Browser auf deinem Rechner und einen SSH-Tunnel zur VM.

Proxmox, VMware, eine Cloud oder Multipass – egal. Auf einem Mac mit Apple Silicon sind Multipass-VMs arm64. Alle Images im Buch gibt es für amd64 und arm64, alle Downloads ermitteln die Architektur selbst (ARCH=$(dpkg --print-architecture)). Die Ausgaben im Buch stammen von amd64; in Dateinamen und Prüfsummen steht bei dir dann arm64.

Helm 4

Das Buch arbeitet durchgehend mit Helm 4.3.2. Gegenüber Helm 3 ändert sich mehr, als die Versionsnummer vermuten lässt: Neue Releases nutzen Server-Side Apply, --wait hat Strategien, --atomic heißt --rollback-on-failure, helm list zeigt jeden Status, Post-Renderer sind Plugins, Plugins werden signiert geprüft, und es gibt neue Template-Funktionen. Tag 14 zeigt die Unterschiede direkt nebeneinander und übt die Migration – Helm 3 bekommt nur noch Sicherheitsupdates bis 10. Februar 2027. Wo das Verhalten von älteren Anleitungen abweicht, sagt es das Kapitel.

Versionen

Komponente Version ab Tag
Ubuntu (VM) 24.04 LTS 0
k3s (Kubernetes) v1.37.2+k3s1 0
Helm v4.3.2 0
yq v4.54.3 0
zot (Chart → Image) 0.1.134/0.1.135 → v2.1.23 1
notes-api 0.7.1 2
postgres 18.7-alpine 9
go-httpbin (helper) 2.26.0 10
curlimages/curl 8.23.0 11
Helm 3 (Vergleich) v3.22.1 14
helm-diff v3.15.15 14
cosign v3.1.4 16
sops / age v3.13.3 / 1.1.1 16
helm-secrets v4.7.11 16
kubeconform v0.8.0 17
trivy v0.76.2 17
pluto v5.24.5 17
helm-unittest v1.2.1 17
chart-testing (ct) v3.15.0 18
Flux (CLI, helm-controller) v2.10.0 (v1.7.1) 18
Argo CD (core) v3.6.2 18

Was du danach kannst

  • Charts von Grund auf schreiben: Werte mit klarer Vorrangregel, Templates mit sauberem Whitespace, Bausteine, Schema, Subcharts, Library Charts, Hooks, Tests und CRDs.
  • Jede Template-Funktion mit helm template nachweisen und die typischen Fallen (default und 0, . im range, lookup ohne Cluster) vermeiden.
  • Releases sicher ausrollen, zurückrollen und verstehen, was Helm in seinen Release-Secrets speichert.
  • Server-Side Apply und Field Manager lesen, Drift erkennen und Helm-3-Releases auf Helm 4 umstellen.
  • Charts über OCI-Registries verteilen, mit GPG und cosign signieren, fremde Charts geprüft spiegeln und Geheimnisse aus Helm heraushalten.
  • Charts ohne Cluster prüfen (Lint, kubeconform, trivy, pluto, helm-unittest) und in einer Pipeline unveränderlich veröffentlichen.
  • Wissen, was Flux, Argo CD und Kustomize mit einem Chart anders machen.
  • Hängende, gescheiterte und fremd besessene Releases in Minuten reparieren, ohne Daten zu verlieren.

Hinweis: Dieses Buch ist ein unabhängiges Übungsbuch. Helm ist ein Projekt der Cloud Native Computing Foundation (CNCF, Status graduated); Helm ist eine Marke der Linux Foundation. Das Buch steht in keiner Verbindung zur Linux Foundation, zur CNCF oder zu den Projekten zot, Flux, Argo CD, cosign und SOPS und wird von ihnen weder geprüft noch unterstützt.

Alle Ausgaben stammen aus echten Läufen, gekürzt, wo es sinnvoll ist. Werte wie der API-Key lab-key-123, das Datenbank-Passwort lab-db-123, der zot-Zugang lab-zot-user/lab-zot-123, das cosign-Passwort lab-cosign-123, der GPG-Schlüssel ohne Passphrase und der age-Schlüssel sind reine Laborwerte – in Produktion gehören sie in einen Passwort-Tresor oder ein KMS, nie in ein Buch.

Viel Spaß im Trainingslager.