Cos'è Docker Compose e perché usarlo?

Question

Accepted Answer

**Docker Compose** è uno strumento per definire ed eseguire **applicazioni multi-container** usando un singolo file YAML. Invece di eseguire manualmente molti comandi `docker run`, descrivi tutti i tuoi servizi (app, database, cache) in `docker-compose.yml` e avviali insieme con un unico comando.

## Il problema che Compose risolve

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## Un docker-compose.yml

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

Un unico file definisce tutti i servizi, le loro immagini/build, porte, ambiente, volumi e dipendenze — e condividono una rete (raggiungendosi a vicenda per nome del servizio, ad es. `db`).

## Eseguire lo stack

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## Perché è importante

Comprendere Docker Compose è prezioso perché le applicazioni reali quasi sempre coinvolgono **molteplici container**, e Compose è lo strumento standard per gestirli, quindi è una conoscenza pratica importante.

Il problema che risolve è reale: un'applicazione tipica ha diversi servizi (un'app web, un database, una cache, forse una coda di messaggi), e eseguire manualmente ognuno con comandi `docker run` separati — configurando porte, reti, volumi, variabili di ambiente e ordine di avvio — è tedioso, soggetto a errori e difficile da riprodurre o condividere. **Compose** affronta questo problema definendo l'**intero stack multi-container in un unico file YAML dichiarativo** e avviando tutto con un singolo comando (`docker compose up`), rendendo le applicazioni multi-container facili da eseguire, riprodurre e condividere.

Comprendere la struttura di `docker-compose.yml` (definendo servizi con le loro immagini/build, porte, ambiente, volumi e dipendenze, con servizi automaticamente in rete e raggiungibili per nome) e i comandi chiave (`up`, `down`, `ps`, `logs`) è una conoscenza pratica, quotidiana per lo sviluppo e per l'esecuzione di applicazioni multi-servizio.

Compose è particolarmente prezioso per gli **ambienti di sviluppo locali** (avviare un'app con il suo database e le sue dipendenze con un unico comando) e per definire stack applicativi in modo riproducibile.

Poiché le applicazioni reali sono tipicamente multi-container, e poiché Docker Compose è lo strumento standard e ampiamente utilizzato per definirle ed eseguirle semplicemente (sostituendo l'orchestrazione manuale tedioso con un unico file dichiarativo e comando), comprendere Docker Compose — ciò che risolve, la struttura del file compose e i comandi — è una conoscenza preziosa e frequentemente applicata per lavorare con applicazioni multi-container, un compagno quasi essenziale di Docker per qualsiasi applicazione containerizzata non banale e uno strumento onnipresente nei flussi di lavoro di sviluppo.