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:
notesfür die Go-APInotes-apimit eigenem PostgreSQL-Subchart, dazu der kleine Diensthelper(go-httpbin) auf Basis des Library Chartsplattform. Der Releasenotes/notesist dein „Produktions“-Release und bleibt grün. Tage, die etwas kaputt machen, arbeiten in Wegwerf-Releases im NamespacetagNN. - Ein Repo: Das Chart wächst in
~/helm/chartsunter 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
notesbleiben 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:5432aus 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 templatenachweisen und die typischen Fallen (defaultund 0,.imrange,lookupohne 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.