Vorwort
Wenig lesen, viel tippen. Irgendwann klickt sich niemand mehr durch Konsolen, um einen Server, eine Datenbank oder einen Keycloak-Realm anzulegen – zu langsam, zu fehleranfällig, nicht nachvollziehbar. Infrastruktur als Code heißt: Was es geben soll, steht in Dateien, liegt im Git, wird im Review geprüft und von einem Werkzeug umgesetzt.
Dieses Buch macht dich sicher mit OpenTofu, dem
freien Fork von Terraform. Du lernst die Sprache und den Lebenszyklus:
init, plan, apply, State,
Variablen, count und for_each, Module. Dann
verwaltest du mehr als Docker: Kubernetes, Helm-Charts und einen
Keycloak-Realm. Danach geht es um den Betrieb im Team: Remote State mit
Sperren und Verschlüsselung, Umgebungen, Import und Refactoring,
Secrets, die nicht im State landen. Am Ende stehen Tests, Policies und
eine Pipeline, die Pläne im Pull-Request zeigt und Drift findet.
Der rote Faden ist notes, eine kleine Notiz-API mit Postgres und nginx davor. Erst entsteht sie als Docker-Container, dann auf Kubernetes mit einer Datenbank vom Operator, mit Anmeldung über Keycloak, als Modul in mehreren Umgebungen – und schließlich verwaltet von einer CI-Pipeline.
Das Buch richtet sich an Admins, Entwickler und Ops-Leute, die Docker und die Kommandozeile kennen und Infrastruktur nicht mehr von Hand bauen wollen.
Die Trainingsregeln
- Tippen, nicht kopieren. Jeder Befehl einmal selbst.
- Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
- Den Plan lesen. Vor jedem
applysteht ein Plan. Wer ihn überspringt, lernt das Ersetzen auf die harte Tour. - Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-db-pw-123,lab-s3-pw-123456und die anderenlab-…-Werte sind Übungsdaten.
Achtung: Alle Ausgaben stammen aus echten Testläufen. Zeiten, IDs und IP-Adressen werden bei dir abweichen. Entscheidend ist, was passiert.
Aufbau jedes Trainingstags
| Abschnitt | Zweck |
|---|---|
| Briefing | Das Nötigste in wenigen Stichpunkten |
| Drills | Befehle und Konfiguration mit erwarteter Ausgabe |
| Kontrollpunkt | Einzelne Prüfbefehle: hat alles geklappt? |
| Challenge | Eine Aufgabe ohne Anleitung |
| Enterprise-Notiz | Was in Produktion anders ist |
Kästen mit Terraform zeigen, wo sich Terraform von OpenTofu unterscheidet. Fast alles in diesem Buch gilt für beide.
Der Trainingsplan
| Teil | Tag | Einheit |
|---|---|---|
| 1 – Grundlagen | 0 | Das Trainingsgelände |
| 1 | Erste Ressourcen mit dem Docker-Provider | |
| 2 | Variablen, Outputs, locals | |
| 3 | State verstehen | |
| 4 | count, for_each und Datenquellen | |
| 5 | Module | |
| 2 – Mehr als Docker | 6 | notes auf Kubernetes |
| 7 | Helm – Postgres und notes als Chart | |
| 8 | Keycloak – Login als Code | |
| 3 – Team-Betrieb | 9 | Remote State, Sperren, Verschlüsselung |
| 10 | Umgebungen – dev und prod | |
| 11 | Import, moved, removed | |
| 12 | Secrets | |
| 4 – Qualität und CI | 13 | fmt, tflint, tofu test, Trivy, Conftest |
| 14 | CI/CD mit Gitea Actions | |
| Wettkampf | 15 | Desaster-Drills |
| Anhang | A | Spickzettel |
| B | Abschlussprüfung |
Das Labor
Gearbeitet wird auf einer Ubuntu-24.04-VM tf mit 4 CPUs
und 8 GB RAM, die du per Multipass startest, per SSH. Jede andere
Linux-VM mit sudo und Internetzugang tut es auch. Alles
läuft lokal: Docker, k3s als Kubernetes, ein S3-kompatibler Speicher für
den State und Gitea für die Pipeline – kein Cloud-Konto nötig.
Die getesteten Versionen: OpenTofu 1.13.2, Docker 29.9, k3s 1.36.5, die Provider kreuzwerker/docker 4.6, hashicorp/kubernetes 3.4, hashicorp/helm 3.3, keycloak/keycloak 5.10 und hashicorp/random 3.9, CloudNativePG 1.30, Keycloak 26.8, Versity S3 Gateway 1.10, tflint 0.65, Trivy 0.76, Conftest 0.71, Gitea 28.3 mit act_runner 0.6.1 und tea 0.16.
Den Begleitcode findest du unter
https://github.com/thomaszachmann/opentofu-zum-anfassen;
Tag 0 holt ihn per git clone. Er enthält notes, das
Helm-Chart und die Lab-Umgebung – die Konfigurationen schreibst du
selbst.
Wo dieses Buch einen Bereich nur anreißt, gehen die Schwesterbücher in die Tiefe: „Kubernetes zum Anfassen” für Cluster und Helm, „Keycloak zum Anfassen” für Realms und Tokens, „Docker Compose zum Anfassen” für den notes-Stack.
Los geht’s.