Dockerignore-Generator
Wähle Sprache, Framework und Extras und erhalte eine sofort einsetzbare .dockerignore. Ein kleinerer Build-Kontext bedeutet schnellere docker build-Läufe, besseres Layer-Caching und keine Geheimnisse oder node_modules, die versehentlich in dein Image kopiert werden.
Zuletzt aktualisiert:
1. Vorlagen wählen
2. Optionen
4. Deine .dockerignore
Speichere die Datei als .dockerignore neben deinem Dockerfile im Stamm des Build-Kontexts (manche Browser entfernen beim Herunterladen den führenden Punkt, benenne sie dann um). Anders als bei .gitignore werden Muster ab dem Kontextstamm abgeglichen, verwende also **/, um in jeder Tiefe zu treffen.
Anleitung: Dockerignore-Generator
- Wähle einen Schnellstart-Stack wie Next.js oder Django oder klicke einzelne Vorlagen für deine Sprache, dein Framework und Extras an.
- Lege die Optionen fest: Behalte Überschriften und Kommentare für bessere Lesbarkeit oder schalte den Allowlist-Modus für den kleinsten Build-Kontext ein.
- Ergänze eigene Einträge für projektspezifische Ordner und verwende !, um eine Datei wieder einzuschließen.
- Prüfe einen Pfad wie src/index.js oder .env, um zu bestätigen, dass er an den Build gesendet oder ausgeschlossen wird.
- Kopiere oder lade die Datei herunter und speichere sie als .dockerignore neben deinem Dockerfile.
Musterregeln für .dockerignore
Docker liest die Datei Zeile für Zeile. Zeilen, die mit # beginnen, sind Kommentare, und das letzte Muster, das auf einen Pfad passt, entscheidet, ob er ausgeschlossen oder eingeschlossen wird.
| Muster | Worauf es passt |
|---|---|
node_modules | Nur node_modules im Kontextstamm und alles darin |
**/node_modules | node_modules in jeder Tiefe, etwa packages/web/node_modules |
*.log | Logdateien nur im Stamm; verwende **/*.log für jeden Ordner |
docs/*.md | Markdown-Dateien direkt in docs, nicht in Unterordnern |
temp? | temp1, tempA: ? ist genau ein Zeichen außer / |
*.py[cod] | .pyc-, .pyo- und .pyd-Dateien im Stamm |
!README.md | Schließt eine Datei wieder ein, die ein früheres Muster ausgeschlossen hat |
*, dann !src | Allowlist: Alles wird ausgeschlossen außer dem Ordner src |
Warum ein kleiner Build-Kontext wichtig ist
- Geschwindigkeit: Der gesamte Kontext wird an den Builder übertragen, bevor die erste Anweisung läuft. Ein vergessener Ordner
node_modulesoder.gitkann jedem Build Hunderte Megabyte hinzufügen. - Caching:
COPY . .wird neu gebaut, sobald sich irgendeine Datei im Kontext ändert. Wenn du Logs, Caches und Editordateien ausschließt, bleibt dieser Layer beim Arbeiten im Cache. - Korrektheit: Auf deinem Laptop installierte Abhängigkeiten sind womöglich für ein anderes Betriebssystem oder eine andere CPU gebaut. Das Ignorieren von
node_modules,.venvodertargeterzwingt eine saubere Installation im Image. - Sicherheit:
.env-Dateien, SSH-Schlüssel und Cloud-Zugangsdaten im Kontext können in einem Layer landen, den jeder mit Pull-Zugriff lesen kann.
Tipps
- Achte in der Ausgabe von
docker buildvor und nach dem Hinzufügen der Datei auf die Größe bei "transferring context", um zu sehen, wie viel sie einspart. - Schlägt ein Build nach dem Hinzufügen einer .dockerignore mit "file not found" fehl, prüfe den Pfad mit der Prüfung oben: Ein breites Muster wie
buildoder**/*.mdschließt womöglich eine Datei aus, die dein Dockerfile kopiert. - Schließe
Testsnur aus, wenn dein Dockerfile die Testsuite nicht während des Builds ausführt. - Kombiniere diese Datei mit einer .gitignore für das Repository und prüfe das Dockerfile selbst mit dem Dockerfile-Linter.
Häufige Fragen
Was macht eine .dockerignore-Datei?
Wenn du docker build ausführst, sendet die CLI den Build-Kontext (meist den aktuellen Ordner) an den Builder. Dateien, auf die .dockerignore passt, werden aus diesem Kontext ausgelassen. Sie können also nicht per COPY oder ADD ins Image kopiert werden, der Upload ist kleiner, und Änderungen an ignorierten Dateien machen den Build-Cache nicht ungültig.
Worin unterscheidet sich .dockerignore von .gitignore?
Die Syntax sieht ähnlich aus, aber der Abgleich unterscheidet sich. In .dockerignore ist jedes Muster relativ zum Stamm des Build-Kontexts, node_modules passt also nur auf den Ordner auf oberster Ebene; verwende **/node_modules, um ihn in jeder Tiefe zu treffen. Ein abschließender Schrägstrich hat keine besondere Bedeutung, und !-Ausnahmen können Dateien in einem ausgeschlossenen Ordner wieder einschließen, was .gitignore nicht erlaubt.
Sollte ich das Dockerfile und die .dockerignore selbst ignorieren?
Das kannst du. Docker sendet beide Dateien trotzdem an den Builder, weil er sie braucht, aber sie werden durch COPY . . nicht ins Image kopiert, und Änderungen daran machen den Cache eines COPY . .-Layers nicht ungültig. Die Vorlage Docker files macht genau das.
Was ist der Allowlist-Modus?
Statt alles aufzulisten, was ausgeschlossen werden soll, beginnt die Datei mit *, um den gesamten Kontext zu ignorieren, und schließt dann nur die Pfade wieder ein, die der Build braucht, etwa !package.json und !src. Das ergibt den kleinstmöglichen Kontext und verhindert Überraschungen, wenn neue Dateien auftauchen, aber du musst daran denken, neue Ordner hinzuzufügen, die der Build nutzt.
Warum sollten .env-Dateien und Schlüssel ignoriert werden?
Alles im Build-Kontext kann über COPY . . in einem Image-Layer landen, und Image-Layer lassen sich von jedem, der das Image ziehen kann, leicht auslesen. Wenn du .env-Dateien, private Schlüssel und Cloud-Zugangsdaten ignorierst, bleiben sie draußen; übergib Geheimnisse stattdessen zur Laufzeit oder mit BuildKit-Secret-Mounts.
Wohin kommt die .dockerignore-Datei?
In den Stamm des Build-Kontexts, also den Ordner, den du an docker build übergibst (der . in docker build .). Mit BuildKit kannst du auch eine Dockerfile-spezifische Datei neben das Dockerfile legen, benannt nach diesem, zum Beispiel app.Dockerfile.dockerignore.
Arbeitet die Pfadprüfung genau wie Docker?
Sie folgt den dokumentierten Regeln: Muster sind am Kontextstamm verankert, * und ? überschreiten keine Ordnertrenner, ** passt auf beliebig viele Ordner, ein Muster, das auf einen Ordner passt, schließt alles darin aus, und die letzte passende Zeile gewinnt. Ungewöhnliche Sonderfälle können trotzdem abweichen, prüfe kritische Pfade also mit einem Test-Build.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.