Wie nutze ich Docker für lokale Entwicklung, ohne dass alles kaputt geht?

Ich versuche seit einem Monat, Docker in meinen Arbeitsablauf zu integrieren, aber jedes Mal, wenn ich die Container hochfahre, bekomme ich Fehler bei Berechtigungen oder Ports, die bereits in Gebrauch sind. Ich arbeite unter Windows mit WSL2 und habe ein Node-Projekt mit PostgreSQL. Gibt es eine Möglichkeit, das hinzubekommen, ohne dass es so kompliziert sein muss?

5 Antworten

★ Beste Antwort

Sind die Berechtigungen nicht so ein Drama, wie es am Anfang aussieht. Die meisten Leute hier konzentrieren sich auf die Ports, und das ist okay, aber was niemand erwähnt, ist dass man in WSL2 dem Docker-Benutzer Berechtigungen geben muss, ohne überall `sudo` einzutippen. Man führt `sudo usermod -aG docker $USER` einfach einmal aus, schließt und öffnet das Terminal neu, und fertig - danach funktioniert Docker, ohne dass man sich jedes Mal mit Berechtigungen rumschlagen muss, wenn man einen Container startet. Danach wird die Konfiguration mit docker-compose viel entspannter, weil man nicht mit Berechtigungsfehlern kämpft, die man mit Port-Fehlern verwechselt.

Die Port-Fehler, dass Ports bereits in Gebrauch sind, sind das Häufigste und Nervigste. Zuerst checkst du, was die Ports belegt: Unter Windows/WSL2 führst du `netstat -ano | findstr :5432` aus (oder deinen Port), um zu sehen, welcher Prozess ihn hat. Falls ein anderer Container hängengeblieben ist, killst du ihn mit `docker rm -f container_name`. Das Berechtigungsproblem kommt meistens daher, dass WSL2 versucht, Volumes ohne die richtigen Berechtigungen unter Windows einzubinden, also definierst du in deiner `docker-compose.yml` explizit die Ports und nutzt am Anfang keine komplizierten Bind Mounts; besser du kopierst den Code ins Image oder nutzt benannte Volumes, die Docker besser verwaltet.

Für dein Setup mit Node + PostgreSQL ist das Sauberstre ein `docker-compose.yml`, in dem du die Services ohne viel Umschweife definierst. Mapp unterschiedliche Ports, falls etwas bereits die Standard-Ports nutzt (z.B. `5433:5432` für Postgres), stell sicher, dass dein Node den Hostname des DB-Containers auflösen kann (nutze den Service-Namen in docker-compose, wie `postgres:5432`), und starten alles sauber neu: `docker-compose down -v` löscht die Container und Volumes, dann `docker-compose up`. Aufgepasst mit benannten Volumes vs. Bind Mounts unter WSL2; Bind Mounts verhalten sich manchmal seltsam mit Berechtigungen, also für lokale Entwicklung würde ich einfach den Code nicht mounten, wenn ich ihn nicht brauch, oder benannte Volumes nutzen, die WSL2 besser verwaltet.

Der Teil, den die meisten nicht machen: Schau dir die Logs an. `docker-compose logs -f` zeigt dir in Echtzeit, was drin abgeht; da siehst du, ob die Anwendung sich wirklich verbindet, ob die DB bereit ist, alles. Und etwas, das besonders unter Windows viele Stunden spart: manchmal haben WSL2 und Docker seltsame Konflikte, also wenn es immer noch ein Chaos ist, versuch Docker Desktop direkt (nicht WSL2) oder stell sicher, dass deine WSL2-Version aktuell ist. Die meisten Leute, die Docker unter Windows aufgeben, aktualisieren WSL2 nicht oder mischen Konfigurationen durcheinander.

Bevor du anfängst, Prozesse zu killen, stell sicher, dass deine `docker-compose.yml` klare Namen für die Services hat und dass die Ports in der Datei nicht hardcodiert sind. Was dir hier hilft, sind Umgebungsvariablen: anstatt `5432:5432` direkt reinzuschreiben, definierst du eine `.env` mit `DB_PORT=5432` und im Compose nutzt du `${DB_PORT}:5432`. So musst du, wenn du den Port wechseln brauchst (weil etwas anderen ihn schon belegt), nur die Konfigurationsdatei an einer Stelle anfassen, anstatt im Code rumzusuchen. Auch bei WSL2 bleiben Container manchmal hängen; bevor du alles neu startest, probier `docker system prune -a`, um das alte Zeug zu löschen, das Stress verursacht.

Der schnellste Weg, um diesen ganzen Ärger zu vermeiden, ist, Umgebungsvariablen in deiner `docker-compose.yml` zu nutzen, statt die Ports hardcodiert reinzuschreiben - so kannst du sie ändern, ohne jedes Mal die Datei anzufassen. Bei mir war das gleiche Problem mit PostgreSQL und Node, die auf WSL2 liefen, und was mir geholfen hat, war einfach, eine `.env`-Datei zu erstellen mit `DB_PORT=5432` und `NODE_PORT=3000`, und sie dann im Compose so zu referenzieren: `${DB_PORT}:5432` - wenn der Port belegt ist, ändere ich eine Zeile in der `.env` und fertig, ohne dass alles zusammenbricht. Ich würde dir auch empfehlen, `restart: unless-stopped` in deinen Services hinzuzufügen, damit sie sich automatisch neu starten, falls was schiefgeht, und bei den Berechtigungsproblemen in WSL2: Führe Docker direkt von WSL aus aus, statt von PowerShell, weil du so die komischen Berechtigungsprobleme zwischen Windows und Linux vermeidest. Noch eine Sache: Wenn du immer noch Probleme mit Containern hast, die nicht sterben wollen, `docker-compose down -v` räumt absolut alles auf, inklusive Volumes, so fängst du wieder bei null an ohne Gespenster.

Docker ist nicht kompliziert, das Problem ist eher, dass WSL2 auf Windows seine eigenen Fallstricke hat, die niemand erwähnt. Was dir viele Stunden spart, ist einfach, nicht mehr an Ports und Berechtigungen als separate Probleme zu denken: Die meisten Probleme entstehen, weil Container nicht miteinander kommunizieren können, weil du localhost statt des Servicenamens innerhalb des Docker-Netzwerks verwendest.

In deiner `docker-compose.yml` schreib in der Verbindungszeichenfolge von Node zu PostgreSQL nicht `localhost:5432`, sondern nutze direkt `postgres:5432` (oder den Namen, den du dem Service gibst). Und in `.env` oder in den Umgebungsvariablen des Containers konfigurierst du die Verbindung so. Das löst 80% der Berechtigungsprobleme, die du siehst: Es ist nicht, dass du keinen Zugriff hast, du zeigst nur in die falsche Richtung. Falls du trotzdem die Ports verschieben willst, exportiere sie in `ports: ["7654:5432"]`, aber innerhalb des Containers nutze immer den Namen des Services, nicht den Port des Hosts.

Deine Antwort

Anmeldenzum Beantworten.