Docker Compose und `.env`-Dateien online validieren
Prüfen Sie die Struktur von `compose.yml` und `.env` vor `docker compose up` — ohne lokale Tools.
Warum Compose und `.env` vor dem Deploy validieren?
Ein `docker compose up`, das an einem falsch eingerückten `services`-Schlüssel oder einer `.env`-Zeile ohne `=` scheitert, kostet Zeit — auf einer neuen Maschine, in der CI oder beim Onboarding. Eine schnelle Struktur-Prüfung vor dem Start des Stacks fängt offensichtliche Tippfehler ab, bevor Docker sich beschwert. Auf FastMinify können Sie eine Docker-Compose-Datei online validieren und eine `.env`-Datei online validieren — vollständig im Browser, ohne Docker- oder Node-Installation. Der gesamte Cluster liegt im Hub DevOps-Werkzeuge, neben Terraform, Dockerfile und HCL.
Häufige Fehler und Workflow vor dem Deploy
Einige Fehler tauchen ständig auf. Sie vor `docker compose up` zu korrigieren, vermeidet kryptische Docker-Meldungen.
Der Validator markiert Schlüssel, die wie Secrets aussehen (`PASSWORD`, `API_KEY`, `SECRET`, `TOKEN`), das ist aber nur eine Erinnerung — kein Secret-Scan. Die eigentliche Disziplin bleibt, `.env`-Dateien nicht zu committen.
Compose vs. `.env`: zwei Absichten
Compose und `.env` ergänzen sich: das eine beschreibt den Stack, das andere injiziert Config. Im Review beide vor dem Start des Stacks validieren.
Was geprüft wird
Wann nutzen
Eine einfache Sequenz vermeidet, Fehler erst beim Deploy zu entdecken.
Wann das Browser-Tool genügt
Sie brauchen kein installiertes Docker, um drei Fehler in einer per Nachricht erhaltenen `compose.yml` zu prüfen.
Grenzen: was der Browser nicht ersetzt
Sobald Sie `${VAR}`-Interpolation auflösen, mehrere Compose-Dateien (`-f`) zusammenführen oder prüfen müssen, ob ein Image existiert, bleiben Docker-CLI und -Daemon Pflicht.
Ein Service kommt oft mit Dockerfile, Terraform-HCL und `.env`. Compose und `.env` validieren + das Dockerfile linten + das HCL formatieren decken den täglichen DevOps-Pfad ab.
CLI und Ökosystem
Die Docker-CLI und einige Linter bleiben der Standard. FastMinify-Tools ergänzen Exploration und One-Shots.
docker compose config
Rendert die finale Datei mit aufgelösten Variablen und meldet Spec-Fehler.
Pros:
Cons:
dotenv-linter
Schneller `.env`-Linter (Rust) mit Regeln für Schlüssel und Werte.
Pros:
Cons:
yamllint
Generischer YAML-Linter, nützlich für Einrückung und Stil.
Pros:
Cons:
Anatomie einer `compose.yml` und einer `.env`
Eine moderne Compose-Datei ist ein einzelnes YAML-Dokument mit einem erforderlichen Top-Level-Schlüssel `services`. Jeder Service sollte ein `image` oder einen `build`-Block deklarieren. Weitere erwartete Top-Level-Schlüssel sind `networks`, `volumes`, `secrets`, `configs`, `name` und das historische `version`. Der Schlüssel `version` ist in der aktuellen Compose-Spec optional, wird aber weiterhin toleriert.
Eine `.env` ist eine Liste von `KEY=VALUE`-Paaren, eines pro Zeile. Leerzeilen und Kommentare (`#`) werden ignoriert, ein `export `-Präfix wird toleriert. Schlüsselnamen folgen der Shell-Konvention (Buchstaben, Ziffern, Unterstrich, nicht mit einer Ziffer beginnend). Ein Wert mit Leerzeichen sollte in Anführungszeichen stehen, um Überraschungen zu vermeiden.
Beide Validatoren führen <strong>strukturelle</strong> Prüfungen aus, keine vollständige Compose-Spec-Validierung und keinen Secret-Scan. Sie lösen keine Variablen-Interpolation (`${VAR}`) auf, prüfen nicht, ob ein Image in einer Registry existiert, und führen kein `docker compose up` aus. Für die Runtime-Wahrheit bleiben `docker compose config` und der Docker-Daemon maßgeblich.
Zwei Validierungen: Compose und `.env`
Der Validator parst das YAML, prüft, dass es ein einzelnes Dokument, einen Mapping-Root und einen `services`-Schlüssel gibt. Er meldet Services ohne `image` oder `build` und unbekannte Top-Level-Schlüssel. Probieren Sie den Online-Docker-Compose-Validator.
Der `.env`-Validator liest jede Zeile, meldet Zeilen ohne `=` oder mit illegalem Schlüssel, erkennt offene Anführungszeichen, doppelte Schlüssel und ungequotete Werte mit Leerzeichen. Nutzen Sie den Online-`.env`-Validator, bevor Sie eine Beispieldatei teilen.
Ein Service steht selten allein. Weiter mit dem Online-Dockerfile-Linter und dem Online-Terraform-/HCL-Formatierer, um die gesamte Infra-Config abzudecken.
Fazit
Die Struktur Ihrer `compose.yml` und `.env` vor `docker compose up` zu validieren, vermeidet Deploy-Fehler durch Tippfehler. Nutzen Sie den Browser als ersten strukturellen Filter, dann `docker compose config` und den Docker-Daemon für die Runtime-Wahrheit. Weiter mit Dockerfile und Terraform-HCL im selben DevOps-Hub.
Verwandte Artikel
Erkennen Sie Docker-Anti-Patterns (Root-User, Cache-Layer, Tag `latest`) und formatieren Sie Dockerfiles vor der CI.
Formatieren und validieren Sie HCL/Terraform vor dem „Terraform-Plan“. Browserbasierte Tools, IaC-Best Practices und häufige Fallstricke.
Optimieren Sie Ihre WordPress-Site mit JavaScript, CSS und HTML-Minimierung. Plugin-Vergleich, Konfiguration und Tipps für ein ultraschnelles WordPress.