Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  1. Tippen, nicht kopieren. Jeder Befehl einmal selbst.
  2. Erwartet vergleichen. Nach jedem Drill steht, was du sehen solltest. Weicht es ab, findest du dort die eigentliche Lektion.
  3. Den Plan lesen. Vor jedem apply steht ein Plan. Wer ihn überspringt, lernt das Ersetzen auf die harte Tour.
  4. Kontrollpunkt bestehen. Erst wenn die Prüfbefehle zeigen, was dort steht, geht es weiter.
  5. Challenge allein lösen. Erst den Hinweis, dann die Lösung.
  6. Lab-Werte bleiben im Lab. lab-db-pw-123, lab-s3-pw-123456 und die anderen lab-…-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.