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
- 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.
- Kontrollpunkt bestehen. Erst wenn jeder Prüfbefehl das Erwartete zeigt, geht es weiter.
- Challenge allein lösen. Erst den Hinweis, dann die Lösung.
- Lab-Werte bleiben im Lab.
lab-api-key-123,lab-artifact-token-123und alle anderenlab-…-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/unddocker build --check.
Los geht’s.
Thomas Zachmann, 2026