Vorwort
Jedes Team, das Kubernetes per Git betreibt, steht irgendwann vor
derselben Frage: Die Manifeste liegen im Repo – und die Passwörter? Die
ehrliche Antwort lautet oft „in einem Wiki“, „im Kopf des Admins“ oder,
schlimmer, „aus Versehen doch im Repo“. Dieses Buch zeigt die zwei
Werkzeuge, mit denen Secrets sicher neben den
Manifesten in Git liegen: sops mit age und OpenBao
Transit, und Sealed Secrets. Und es zeigt, woran die
Praxis scheitert: an einem MAC, der nach einem harmlosen
sed nicht mehr stimmt, an einer Kollegin, die zwar in
.sops.yaml steht, aber nicht in der Datei, an einem
kubectl apply, das den privaten Schlüssel im Klartext in
eine Annotation schreibt, und an einem Controller, dessen Schlüssel nach
dem Neuaufbau weg ist.
Du baust über 16 Tage ein eigenes Secrets-Repo auf: erst age allein, dann sops mit allen Dateiformaten, Regeln pro Ordner, Teams, Schlüsselwechsel, Shamir-Gruppen und OpenBao als Schlüsselquelle. Danach schützt du das Repo gegen Klartext, lässt Flux und Argo CD entschlüsseln, betreibst Sealed Secrets samt Schlüsselsicherung und ziehst am Ende einen Namespace von Sealed Secrets nach sops um. Das Messgerät des Buchs ist das Paar verschlüsseln – nachweisen: Jede Funktion beginnt mit Klartext und endet mit einem Befehl, der zeigt, wer jetzt was lesen kann – und wer nicht.
Das Buch richtet sich an Plattform- und DevOps-Engineers und
Entwickler mit Kubernetes- und Git-Grundlagen: Du solltest Secrets und
Namespaces kennen, kubectl apply bedienen und mit Branches
und Commits umgehen können. Kryptografie musst du nicht studiert haben;
was du davon brauchst, erklärt das jeweilige Briefing.
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“.
- Klartext → verschlüsseln → in Git ansehen → nachweisen. Jeder Nachweis ist ein Befehl mit „Erwartet“. Fehlerbilder folgen dem Muster Einbauen → Symptom → Untersuchen → Ursache → Fix → Nachweis.
- Kein Hilfsskript. Jeder Schritt steht als einzelner Befehl da, Dateien als Heredoc. Einzige Ausnahme ist der Git-Hook in Tag 9 – er ist Lernstoff und steht vollständig im Text.
- Speed-Drills, 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.
- Ein Repo durch alle Tage:
lab/secretsauf einem eigenen Forgejo, geklont nach~/sops/repo. Es wächst Tag für Tag um Ordner und Regeln:notes/,dev/,prod/,tresor/,plattform/,argocd/,sealed/,backup/,stage/. Tage, die etwas kaputt machen, arbeiten in einem eigenen Klon.
Zum Schluss:
- Wettkampf (Tag 16): acht eingebaute Pannen quer durch das Buch, unter Zeitdruck.
- Anhang A ist der Spickzettel mit einer Tabelle „Meldung → Ursache → Tag“, Anhang B die Abschlussprüfung: ein neues Secrets-Repo vom ersten Schlüssel bis zum Ausrollen, dazu Team, Shamir, Transit, Sealed Secrets und Fehlersuche.
Die Tage im Überblick
| Tag | Thema | Dauer |
|---|---|---|
| 0 | Trainingsgelände: k3s, Werkzeuge, Forgejo, Repo | ca. 60 min |
| 1 | age allein: Schlüssel, Recipients, Passphrase, SSH-Schlüssel | ca. 60 min |
| 2 | sops-Grundlagen: encrypt, decrypt, edit, set, Aufbau der Datei | ca. 60 min |
| 3 | Dateiformate und Teilverschlüsselung, MAC | ca. 60 min |
| 4 | .sops.yaml: Regeln, Umgebungen, Schlüsselsuche |
ca. 60 min |
| 5 | Team: Recipients hinzufügen, entfernen, rotieren | ca. 75 min |
| 6 | Shamir: Key Groups und Schwellwert | ca. 60 min |
| 7 | OpenBao Transit als Schlüsselquelle, Notfallschlüssel | ca. 75 min |
| 8 | Alltag: exec-env, exec-file, lesbare Diffs, keyservice | ca. 60 min |
| 9 | Schutz gegen Klartext: gitleaks, Pre-commit-Hook, Leck-Plan | ca. 60 min |
| 10 | Flux entschlüsselt: age, mehrere Schlüssel, OpenBao-Token | ca. 75 min |
| 11 | Argo CD entschlüsselt: KSOPS, eigener Schlüssel, Cache | ca. 75 min |
| 12 | Sealed Secrets: Controller, kubeseal, Scopes | ca. 75 min |
| 13 | Sealed Secrets: Schlüssel sichern, erneuern, wiederherstellen | ca. 75 min |
| 14 | Fehlerbilder: MAC, AES-GCM, Merge, Recipients, Controller | ca. 75 min |
| 15 | Entscheiden und migrieren, ein neues Repo | ca. 60 min |
| 16 | Wettkampf: das Leck im Repo | ca. 120 min |
Zeit: Tag 0 bis 15 summieren sich auf knapp 18 Stunden (1065 Minuten), der Wettkampf und die Abschlussprüfung kommen mit je zwei Stunden dazu – insgesamt knapp 22 Stunden. Bei einem Trainingstag pro Abend und fünf Abenden pro Woche bist du in gut drei Wochen durch.
Die Reihenfolge ist kein Zufall: Ab Tag 2 liegt dein Schlüssel in
keys.txt, ab Tag 5 ist es ein neuer, ab Tag 7 hängen
prod/ und plattform/ zusätzlich an OpenBao, ab
Tag 9 lässt der Hook keinen Klartext mehr durch, und ab Tag 12 läuft der
Sealed-Secrets-Controller, dessen Schlüssel Tag 13 sichert.
Das Trainingsgelände
Das ganze Buch läuft auf einer VM, Benutzer
ubuntu, Arbeitsordner ~/sops/tagNN/:
| Rolle | Aufgabe | IP im Buch | Im Labor |
|---|---|---|---|
| argo | k3s-Single-Node, Forgejo, OpenBao, Arbeitsplatz | 172.16.0.182 | 4 vCPU, 7,7 GiB RAM |
- k3s v1.37.2+k3s1 ohne metrics-server, StorageClass
local-path. Tag 0 installiert alles; Werkzeuge kommen als Binärdateien mit Prüfsumme. - Forgejo läuft im Cluster (NodePort 30300) und ist der Git-Server des Buchs – ohne Konto bei einem Anbieter.
- OpenBao läuft ab Tag 7 im Dev-Modus (NodePort 30820). Dev-Modus heißt: Speicher im RAM, ein Pod-Neustart löscht die Transit-Schlüssel – das ist Teil des Lernstoffs.
- Flux (Tag 10) und Argo CD (Tag 11) laufen nur an ihrem Tag und gehen danach wieder vom Cluster. Mit 4 GiB RAM kommst du hin, mit 8 GiB wird es entspannt.
Ehrlich gesagt, was die Tage voraussetzen:
- Internetzugang der VM für Images (codeberg.org, quay.io, ghcr.io, docker.io) und Werkzeug-Downloads von den offiziellen Release-Seiten. Jede Binärdatei wird gegen die veröffentlichte Prüfsumme geprüft – außer age, das statt einer Prüfsummendatei Transparenz-Nachweise (Sigsum) veröffentlicht (Tag 0).
- Tag 2 und 11: ein Browser auf deinem Rechner, wenn du Forgejo und Argo CD selbst ansehen willst – die Screenshots im Buch zeigen dasselbe.
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.
Abgrenzung
Wie OpenBao selbst betrieben wird – Raft, Unseal, Auth-Methoden, External Secrets Operator, dynamische Secrets – zeigen „OpenBao zum Anfassen“ und „OpenBao-Secrets zum Anfassen“; hier ist OpenBao nur Schlüsselquelle für sops. GitOps-Grundlagen stehen in „Flux zum Anfassen“ (Tag 8) und „GitOps mit Argo CD zum Anfassen“ (Tag 10), helm-secrets in „Helm Charts zum Anfassen“ (Tag 16) und Secrets im Cluster (etcd-Verschlüsselung, RBAC) in „Kubernetes angreifen und absichern zum Anfassen“ (Tag 10).
Versionen
| Komponente | Version | ab Tag |
|---|---|---|
| Ubuntu (VM) | 24.04 LTS | 0 |
| k3s (Kubernetes) | v1.37.2+k3s1 | 0 |
| sops | v3.13.3 | 0 |
| age | v1.3.2 | 0 |
| Helm | v4.3.2 | 0 |
| yq | v4.54.3 | 0 |
| Forgejo (rootless) | 17.0.2 | 0 |
| OpenBao (Server und CLI) | v2.7.3 | 7 |
| gitleaks | v8.30.1 | 9 |
| Flux | v2.10.0 | 10 |
| Argo CD (Chart 10.18.2) | v3.6.2 | 11 |
| KSOPS | v4.5.1 | 11 |
| Sealed Secrets (Chart 2.22.0), kubeseal | v0.41.2 | 12 |
Was du danach kannst
- age-Schlüssel erzeugen, schützen und Dateien für mehrere Recipients verschlüsseln.
- Mit sops YAML, JSON, dotenv, INI und Binärdateien ganz oder teilweise verschlüsseln und den Aufbau einer verschlüsselten Datei lesen.
- Regeln pro Ordner und Umgebung schreiben, Teammitglieder aufnehmen und entfernen, Datenschlüssel rotieren und Shamir-Gruppen einsetzen.
- OpenBao Transit als Schlüsselquelle nutzen – mit einem Notfallweg, wenn OpenBao ausfällt.
- Ein Repo so absichern, dass Klartext gar nicht erst committet wird, und wissen, was nach einem Leck zu tun ist.
- Flux und Argo CD entschlüsseln lassen – und wissen, wo der Klartext dabei liegt.
- Sealed Secrets betreiben, die Schlüssel sichern, erneuern und nach einem Clusterverlust wiederherstellen.
- Jede typische Meldung einer Ursache zuordnen und zwischen sops, Sealed Secrets und einem externen Speicher begründet entscheiden.
Was geprüft wurde
Alle Befehle und Ausgaben stammen aus echten Läufen auf dem
beschriebenen Gelände im November 2026, gekürzt, wo es sinnvoll ist.
Jeder Tag wurde Block für Block in der Reihenfolge des Buchs auf
argo ausgeführt, die meisten Tage danach ein zweites Mal
aus frischem Zustand nachgespielt; Ausgaben, die sich dabei änderten,
sind nachgezogen. Auch alle Lösungen aus Anhang B sind nachgespielt.
Schlüssel, Chiffretexte, Commit-IDs, Pod-Namen und Zeitstempel sind bei
dir andere – die Form der Ausgaben bleibt gleich.
Hinweis: Dieses Buch ist ein unabhängiges Übungsbuch. SOPS (getsops) ist ein Projekt der Cloud Native Computing Foundation (CNCF, Sandbox). age ist ein Projekt von Filippo Valsorda, Sealed Secrets ein Open-Source-Projekt von bitnami-labs, KSOPS ein Open-Source-Projekt von Viaduct. OpenBao ist ein Projekt der Linux Foundation (OpenSSF). Flux und Argo CD sind CNCF-Projekte, Kubernetes ist eine Marke der Linux Foundation. Forgejo ist ein Projekt von Codeberg e. V. Das Buch steht mit keinem dieser Projekte in Verbindung und wird von ihnen weder geprüft noch unterstützt.
Werte wie lab-db-123, lab-forgejo-123 und
lab-bao-123 sind reine Laborwerte; die age-Schlüssel im
Buch wurden im Labor erzeugt und erscheinen nie vollständig mit ihrem
privaten Teil.