Zum Inhalt springen
Trainingslager IT-Trainingslager

Vorwort

Wenig lesen, viel tippen. Dieses Buch beginnt mit einem schlechten Dockerfile: ein Stage, das ganze Projekt per COPY . ., ein Image über ein Gigabyte groß, der Prozess läuft als root, und der API-Key steht als ENV mitten im Image. Tag für Tag machst du daraus ein Image, das nur noch das Nötigste enthält, schnell baut, als normaler User läuft und kein Secret mehr preisgibt. Alles läuft auf deinem Laptop: Docker mit BuildKit, eine lokale Registry und eine kleine Demo-Anwendung notes aus einem Go-API, einem Python-Worker und einer Node-Oberfläche.

Der zweite Schwerpunkt sind Secrets. Ein API-Key gehört weder ins Git-Repository noch in ein Image-Layer, und trotzdem brauchen ihn Build und Container. Du siehst selbst, wie ein Key über ARG, ENV, COPY oder ein vergessenes rm im Image landet und wie man ihn dort wiederfindet. Danach baust du es richtig: .env nur lokal, .gitignore und .dockerignore als Schutzschicht, Build-Secrets per RUN --mount=type=secret und Laufzeit-Secrets als Dateien statt als Umgebungsvariablen.

Das Buch richtet sich an Platform Engineers, Entwicklerinnen und Entwickler sowie DevOps- und Security-Leute, die Dockerfiles nicht nur zum Laufen bringen, sondern verstehen, prüfen und im Team durchsetzen wollen.

Geprüft wird mit fünf Werkzeugen, die sich ergänzen: hadolint und die Build Checks von BuildKit lesen das Dockerfile, ShellCheck die Skripte, trivy sucht Fehlkonfigurationen, Secrets und bekannte Lücken, und dockle prüft das fertige Image. Den Begleitcode findest du auf GitHub unter https://github.com/thomaszachmann/dockerfiles-zum-anfassen.

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. Kontrollpunkt bestehen. Erst wenn jeder Prüfbefehl das Erwartete zeigt, geht es weiter.
  4. Challenge allein lösen. Erst den Hinweis, dann die Lösung.
  5. Lab-Werte bleiben im Lab. lab-api-key-123, lab-artifact-token-123 und alle anderen lab-…-Werte sind Übungsdaten. Ein echter Key gehört nie in eine Datei, die du in diesem Buch anlegst.

Achtung: Base-Images bekommen laufend neue Versionen und Sicherheitsupdates. Image-Größen, Digests, Build-Zeiten und die Zahl gefundener CVEs werden bei dir abweichen. Entscheidend ist das Verhältnis: vorher gegen nachher.

Aufbau jedes Trainingstags

Abschnitt Zweck
Briefing Das Nötigste in wenigen Stichpunkten
Drills Befehle mit erwarteter Ausgabe
Kontrollpunkt Prüfskript: hat alles geklappt?
Challenge Eine Aufgabe ohne Anleitung
Enterprise-Notiz Was in Produktion anders ist

Der Trainingsplan

Teil Tag Einheit
Gelände 0 Docker, buildx, lokale Registry, Demo-Anwendung, Aufräumen
A – Grundlagen 1 Das erste Dockerfile: Images, Container, Layer
2 Anweisungen im Detail: ENTRYPOINT, PID 1, ARG, ENV, HEALTHCHECK
3 Build-Kontext und .dockerignore
4 Layer-Cache meistern
B – Multi-Stage 5 Multi-Stage-Grundlagen: Go nach scratch
6 Multi-Stage für Python und Node
7 Fortgeschrittene Muster und Multi-Plattform
8 Base-Images wählen
C – Best Practices 9 Härten: non-root, read-only, Build Checks
10 Nachvollziehbar und geprüft: Labels, SBOM, Trivy
D – Secrets 11 Wie Secrets durchsickern
12 .env, .gitignore und .dockerignore
13 Build-Secrets mit BuildKit
14 Laufzeit-Secrets
Wettkampf 15 Desaster-Drills
Anhang A Spickzettel
B Abschlussprüfung

Teil A zeigt, was beim Bauen eines Images wirklich passiert. Teil B macht das Image klein. Teil C macht es sicher und überprüfbar. Teil D sorgt dafür, dass kein Secret im Repository, im Image oder im Build-Log landet. Tag 15 trainiert den Ernstfall.

Tipp: Die getesteten Versionen von Docker, buildx, Compose und allen Base-Images stehen an Tag 0. Weicht eine Option bei dir ab: die Dockerfile-Referenz unter docs.docker.com/reference/dockerfile/ und docker build --check.

Los geht’s.

Thomas Zachmann, 2026