Docker-Compose-Validator
Füge eine docker-compose.yml oder compose.yaml ein, um sie sofort zu prüfen. Der Validator findet YAML-Syntaxfehler, unbekannte oder falsch geschriebene Schlüssel, falsche Werttypen, fehlerhafte Verknüpfungen zwischen Diensten, Netzwerken, Volumes und Secrets, Konflikte bei Host-Ports und veraltete Optionen, jeweils mit Zeilennummer und Lösung.
Zuletzt aktualisiert:
Gefundene Dienste
| Dienst | Image / Build | Ports | Hängt ab von |
|---|
Anleitung: Docker-Compose-Validator
- Füge deine Compose-Datei in den Editor ein, lade eine docker-compose.yml hoch oder lade eines der Beispiele.
- Lies die Zusammenfassung: Sie zeigt, ob die Datei gültig ist und wie viele Fehler, Warnungen und Tipps gefunden wurden.
- Klicke auf ein Problem, um zur passenden Zeile zu springen; Fehler sind rot und Warnungen gelb markiert.
- Behebe die Probleme im Editor; die Datei wird beim Tippen automatisch erneut geprüft.
- Filtere oder kopiere den Bericht, um ihn in einem Pull Request oder Ticket zu teilen, und führe dann lokal
docker compose configzur abschließenden Prüfung aus.
Häufige Docker-Compose-Fehler und wie du sie behebst
Die meisten fehlerhaften Compose-Dateien scheitern an einer Handvoll Gründe. Die Tabelle listet die Meldungen, die du hier wahrscheinlich siehst, ihre Ursachen und die übliche Lösung.
| Problem | Typische Ursache | Lösung |
|---|---|---|
| Falsche Einrückung | Ein Schlüssel ist mit einer anderen Anzahl Leerzeichen eingerückt als seine Geschwister, oder es wurde ein Tabulator verwendet | Verwende nur Leerzeichen und halte alle Schlüssel eines Dienstes in derselben Spalte |
| Unbekannter Schlüssel | Ein Tippfehler (enviroment, depend_on) oder ein Schlüssel auf der falschen Ebene | Verwende die vorgeschlagene Schreibweise; eigene Schlüssel müssen mit x- beginnen |
| Benanntes Volume nicht deklariert | data:/app/data verweist auf ein benanntes Volume, das im volumes: auf oberster Ebene fehlt | Ergänze volumes: {data: {}} oder schreibe ./data:/app/data für einen Bind Mount |
| Netzwerk nicht deklariert | Ein Dienst tritt einem eigenen Netzwerk bei, das nicht definiert ist | Füge es unter networks: auf oberster Ebene hinzu; nur default existiert automatisch |
| Dienst hat weder image noch build | Der Dienst setzt nur ports oder environment | Ergänze image: name:tag oder build: ./folder |
| Host-Port bereits veröffentlicht | Zwei Dienste nutzen denselben Host-Port, zum Beispiel beide "80:…" | Gib jedem einen anderen Host-Port oder binde sie an unterschiedliche IPs |
| Zirkuläre Abhängigkeit | A hängt von B ab und B (direkt oder indirekt) von A | Entferne eine Richtung; nutze Healthchecks und Wiederholungen statt gegenseitigen Wartens |
| Ungültige Zeitangabe | interval: 30 seconds oder timeout: 5 | Schreibe eine Zahl mit Einheit: 30s, 1m30s, 500ms |
| Boolescher Wert erwartet | privileged: yes ist in YAML 1.2 ein String | Verwende true oder false |
Veraltete und überholte Compose-Schlüssel
Die Compose-Spezifikation hat die getrennten Dateiformate Version 2 und Version 3 ersetzt. Einige ältere Optionen funktionieren noch, werden aber nicht mehr empfohlen:
version: veraltet. Compose v2 ignoriert den Schlüssel und warnt davor. Lösche die Zeile; die neuesten Funktionen sind immer verfügbar.links: überholt. Jeder Dienst in einem gemeinsamen Netzwerk erreicht die anderen bereits über den Dienstnamen, zum Beispieldb:5432. Nutzedepends_onfür die Startreihenfolge und Netzwerk-aliasesfür zusätzliche Hostnamen.external_links: überholt. Verbinde stattdessen beide Projekte mit demselben externen Netzwerk.external: {name: …}: veraltet. Schreibename: shared_netundexternal: truebeim Netzwerk oder Volume.
Tipps für eine saubere Compose-Datei
- Lege Image-Tags fest (
postgres:16-alpinestattpostgresoder:latest), damit jedes Deployment dieselbe Version ausführt. - Ergänze einen
healthcheckfür Datenbanken und Caches und nutzecondition: service_healthyindepends_on, damit abhängige Dienste erst starten, wenn sie sich verbinden können. - Halte Geheimnisse aus der Datei heraus: Verweise auf
${DB_PASSWORD}aus einer nicht versionierten.env-Datei oder nutze den Abschnittsecretsauf oberster Ebene und*_FILE-Variablen. - Veröffentliche Datenbank-Ports nur, wenn du sie vom Host aus brauchst; Container im selben Netzwerk erreichen sich ohne
ports. Falls doch, binde sie an127.0.0.1. - Vermeide
container_name, außer ein anderes Tool braucht einen festen Namen; es verhindert Skalierung und kann zwischen Projekten kollidieren. - Führe nach dem Bearbeiten
docker compose configaus, um die endgültige Datei mit eingesetzten Variablen und zusammengeführten Override-Dateien zu sehen.
Häufige Fragen
Was prüft dieser Docker-Compose-Validator?
Er parst die Datei als YAML und vergleicht dann jeden Schlüssel und Wert mit der Compose-Spezifikation, die Docker Compose v2 verwendet: erlaubte Schlüssel, Werttypen, Aufzählungen wie Neustartrichtlinien und depends_on-Bedingungen sowie Zeitformate. Danach prüft er die Beziehungen zwischen den Teilen der Datei, zum Beispiel ob jedes Netzwerk, jedes benannte Volume, jedes Secret und jede Abhängigkeit, die ein Dienst nutzt, tatsächlich definiert ist.
Wird der Schlüssel version in der docker-compose.yml noch benötigt?
Nein. Docker Compose v2 folgt der Compose-Spezifikation, die den Schlüssel version auf oberster Ebene als veraltet behandelt. Compose ignoriert ihn und gibt eine Warnung aus, dass das Attribut veraltet ist, du kannst die Zeile also löschen. Der Validator meldet ihn als veralteten Schlüssel.
Warum heißt es, mein benanntes Volume sei nicht deklariert?
Ein Volume-Eintrag wie db_data:/var/lib/mysql nutzt ein benanntes Volume, weil die Quelle keinen Schrägstrich und keinen Punkt enthält. Benannte Volumes müssen im Abschnitt volumes auf oberster Ebene aufgeführt sein (ein leerer Eintrag wie db_data: genügt). Wenn du einen Ordner auf deinem Computer meintest, schreibe ihn als Pfad, etwa ./db_data:/var/lib/mysql.
Worin unterscheidet sich das von docker compose config?
docker compose config ist die maßgebliche Prüfung, weil dabei die echte Compose-Engine läuft, Umgebungsvariablen aufgelöst und Override-Dateien zusammengeführt werden. Dieses Tool funktioniert ohne installiertes Docker, erklärt jedes Problem in verständlicher Sprache, ergänzt Best-Practice-Tipps und sendet die Datei nirgendwohin. Nutze beides: dieses Tool beim Bearbeiten, docker compose config vor dem Deployment.
Ersetzt der Validator ${VARIABLEN} durch Werte?
Nein. Variablen bleiben so, wie sie geschrieben sind, weil ihre Werte aus deiner Shell oder der .env-Datei kommen. Der Validator prüft, ob jede Interpolation korrekt aufgebaut ist, zum Beispiel ${VAR}, ${VAR:-default} oder ${VAR:?message}, und überspringt Typprüfungen bei Werten, die eine Variable enthalten.
Warum sollten Portzuordnungen in Anführungszeichen stehen?
YAML-1.1-Parser lesen einen Wert ohne Anführungszeichen wie 22:22 als Zahl zur Basis 60. Docker Compose v2 nutzt YAML 1.2 und verarbeitet ihn korrekt, andere Tools in deiner Pipeline aber vielleicht nicht. Wenn du jede Zuordnung in Anführungszeichen setzt, etwa "8080:80", vermeidest du das Problem überall.
Wird meine Compose-Datei hochgeladen?
Nein. Der Validator und der YAML-Parser laufen in deinem Browser. Die Datei wird nie an einen Server gesendet, daher kannst du auch Dateien mit internen Hostnamen oder Zugangsdaten bedenkenlos prüfen.
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.