Docker Compose per lo sviluppo: servizi, volumi e healthcheck

Risposta breve: scrivi un compose.yaml con i servizi che il progetto richiede, avvia docker compose up -d e segui l'output con docker compose logs -f. Il file resta nel repository e vale per tutto il team.

Un compose.yaml che parte

services:
  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_PASSWORD: dev
    ports:
      - "5432:5432"
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      retries: 10
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgres://postgres:dev@db:5432/postgres
    depends_on:
      db:
        condition: service_healthy
volumes:
  db-data:

Due servizi bastano nella maggior parte dei progetti: database e applicazione. Il volume nominato db-data conserva i dati tra un riavvio e l'altro, e depends_on con condition: service_healthy aspetta che Postgres risponda, non solo che il container parta.

I comandi che si usano ogni giorno

docker compose up -d
docker compose ps
docker compose logs -f app
docker compose exec db psql -U postgres -c '\dt'
docker compose down

ps mostra stato e porte, logs -f segue un servizio, exec entra in un container già avviato. down ferma e rimuove i container, ma lascia i volumi: i dati restano.

Dati locali: quando cancellarli davvero

docker compose down -v
docker compose exec db psql -U postgres -c 'select count(*) from users;'

down -v elimina anche i volumi. È il comando giusto per ripartire da un database vuoto e quello sbagliato da lanciare per abitudine: non chiede conferma e non ha undo. Controlla prima con docker volume ls.

Override per il team

Un compose.override.yaml viene unito in automatico al file base: mount del codice, porte esposte, comando di watch. Tieni l'override fuori dal repository se contiene percorsi personali.

Limite dichiarato

Su Windows i bind mount passano da WSL2 e costano: un node_modules montato dall'host rallenta l'avvio in modo evidente. La documentazione Docker suggerisce un volume nominato o una cache di build per le dipendenze, non il bind mount.

Dove continuare

Nel catalogo trovi il system monitor, la card con metrica di avanzamento e i blocchi di dashboard. Per il resto leggi la struttura di un monorepo Next.js, gli indici PostgreSQL utili e il confronto Next.js o Vite.