Zum Inhalt springen
Trainingslager IT-Trainingslager

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/secrets auf 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.