Come usare Docker per lo sviluppo locale senza che vada tutto in pezzi?

MO Monica Torres MX 📗 Studente 👁 85 ⚑ Segnala Programmazione

Sto cercando da un mese di inserire Docker nel mio flusso di lavoro, ma ogni volta che avvio i contenitori mi butta fuori errori di permessi o porte già in uso. Lavoro su Windows con WSL2 e ho un progetto Node con PostgreSQL. C'è un modo per farlo senza che sia così complicato?

5 risposte

★ Miglior risposta

I permessi non sono un casino grande come sembra all'inizio, la maggior parte della gente qua si concentra sulle porte e va bene, ma quello che nessuno menziona è che su WSL2 devi dare i permessi all'utente Docker senza mettere `sudo` in tutto. Esegui `sudo usermod -aG docker $USER` una sola volta, chiudi e riapri il terminale, e fatto - dopo Docker funziona senza che tu debba stare a litigare con i permessi ogni volta che avvii un contenitore. Dopo di quello, la configurazione con docker-compose diventa molto più tranquilla perché non stai affrontando errori di permessi che ti confondono con quelli delle porte.

Sergio MX 🛠️ Specialista 💬 70 risposte ⚑

Gli errori di porte già in uso sono il problema più comune e fastidioso. Per prima cosa controlla cosa sta occupando le porte: su Windows/WSL2 esegui `netstat -ano | findstr :5432` (o la porta che usi) per vedere quale processo la tiene. Se è un altro contenitore rimasto bloccato, terminalo con `docker rm -f nome_contenitore`. Il problema dei permessi di solito viene dal fatto che WSL2 prova a montare volumi senza i permessi corretti su Windows, quindi nel tuo `docker-compose.yml` specifica esplicitamente le porte e non usare bind mount complicati all'inizio; meglio copiare il codice nell'immagine o usare volumi nominati che Docker gestisce meglio.

Per il tuo setup Node + PostgreSQL, la soluzione più pulita è un `docker-compose.yml` dove definisci i servizi senza complicarti troppo. Mappa porte diverse se qualcosa sta già usando quelle standard (es: `5433:5432` per Postgres), assicurati che il tuo Node riesca a risolvere l'hostname del contenitore del database (usa il nome del servizio in docker-compose, tipo `postgres:5432`), e riavvia tutto pulito: `docker-compose down -v` termina i contenitori e i volumi, poi `docker-compose up`. Occhio ai volumi nominati vs bind mount su WSL2; i bind mount a volte si comportano strano con i permessi, quindi per lo sviluppo locale considera semplicemente di non montare il codice se non ne hai bisogno, o usa volumi nominati che WSL2 gestisce meglio.

La parte che la maggior parte non fa: controlla i log. `docker-compose logs -f` ti mostra cosa succede dentro in tempo reale; lì vedi se l'applicazione si connette davvero, se il database è pronto, tutto. E una cosa che ti fa risparmiare tante ore, specialmente su Windows: a volte WSL2 e Docker hanno conflitti strani, quindi se rimane un caos, prova Docker Desktop direttamente (non WSL2) o assicurati che la tua versione di WSL2 sia aggiornata. La maggior parte della gente che abbandona Docker su Windows lo fa perché non aggiorna WSL2 o mescola configurazioni.

Prima di iniziare a killare i processi, assicurati che il tuo `docker-compose.yml` abbia nomi chiari per i servizi e che le porte nel file non siano hardcodificate. Quello che ti salva qui è usare le variabili d'ambiente: invece di mettere `5432:5432` diretto, definisci un `.env` con `DB_PORT=5432` e nel compose usi `${DB_PORT}:5432`. Così quando devi cambiar porta (perché qualcosa l'occupa già) tocchi il file di configurazione in un solo posto, senza andare a cercarlo per tutto il codice. Anche, su WSL2 a volte i container rimangono bloccati; prima di riavviare tutto, prova `docker system prune -a` per pulire la roba vecchia che sta causando casini.

Il modo più veloce per evitare questi casini è usare variabili d'ambiente nel tuo `docker-compose.yml` invece di hardcodare le porte, così puoi cambiarle senza toccare il file ogni volta. Nel mio caso avevo lo stesso problema con PostgreSQL e Node che giravano in WSL2, e quello che mi ha salvato è stato semplicemente creare un file `.env` con `DB_PORT=5432` e `NODE_PORT=3000`, poi referenziarli nel compose come `${DB_PORT}:5432` - se la porta è occupata cambio una sola riga nel `.env` e fatto, senza che salti tutto in aria. Ti consiglio anche di aggiungere `restart: unless-stopped` nei tuoi servizi così si riavviano automaticamente se qualcosa va male, e per i permessi in WSL2, esegui Docker direttamente da WSL invece che da PowerShell, perché così eviti i strani problemi di permessi tra Windows e Linux. Un'ultima cosa: se continui ad avere storie di container che non vogliono morire, `docker-compose down -v` ti pulisce tutto completamente inclusi i volumi, così ripeti da zero senza fantasmi.

Non è che Docker sia complicato, è che WSL2 su Windows ha le sue trappole personali e nessuno le menziona. Quello che ti farà risparmiare ore è semplicemente smettere di pensare a porte e permessi come problemi separati: la maggior parte dei casini viene dal fatto che i contenitori non riescono a comunicare tra loro perché usi localhost invece del nome del servizio nella rete di Docker.

Nel tuo `docker-compose.yml`, nella stringa di connessione di Node a PostgreSQL non mettere `localhost:5432`, usa direttamente `postgres:5432` (o il nome che dai al servizio). E in `.env` o nelle variabili del contenitore, configura la connessione così. Questo risolve l'80% dei drammi di permessi che vedi: non è che non hai accesso, è che stai puntando male. Se comunque vuoi spostare le porte, esportale in `ports: ["7654:5432"]` ma dentro il contenitore usa sempre il nome del servizio, non la porta dell'host.

La tua risposta

Accediper rispondere.