Qu'est-ce que Docker Compose et pourquoi l'utiliser ?

Question

Accepted Answer

**Docker Compose** est un outil pour définir et exécuter des **applications multi-conteneurs** en utilisant un seul fichier YAML. Au lieu d'exécuter manuellement plusieurs commandes `docker run`, vous décrivez tous vos services (app, base de données, cache) dans `docker-compose.yml` et les démarrez ensemble avec une seule commande.

## Le problème que Compose résout

```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 seul fichier définit tous les services, leurs images/builds, ports, environnements, volumes et dépendances — et ils partagent un réseau (se rejoignant mutuellement par nom de service, par ex. `db`).

## Exécuter la pile

```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
```

## Pourquoi c'est important

Comprendre Docker Compose est précieux car les applications réelles impliquent presque toujours des **conteneurs multiples**, et Compose est l'outil standard pour les gérer, c'est donc une connaissance pratique importante.

Le problème qu'il résout est réel : une application typique a plusieurs services (une application web, une base de données, un cache, peut-être une file d'attente de messages), et exécuter manuellement chacun avec des commandes `docker run` séparées — en configurant les ports, les réseaux, les volumes, les variables d'environnement et l'ordre de démarrage — est fastidieux, source d'erreurs et difficile à reproduire ou partager. **Compose** y remédie en définissant la **pile multi-conteneurs entière dans un seul fichier YAML déclaratif** et en la démarrant avec une seule commande (`docker compose up`), rendant les applications multi-conteneurs faciles à exécuter, reproduire et partager.

Comprendre la structure de `docker-compose.yml` (définir les services avec leurs images/builds, ports, environnement, volumes et dépendances, avec les services automatiquement en réseau et accessibles par nom) et les commandes clés (`up`, `down`, `ps`, `logs`) est une connaissance pratique et quotidienne pour le développement et l'exécution d'applications multi-services.

Compose est particulièrement précieux pour les **environnements de développement local** (lancer une application avec sa base de données et ses dépendances en une seule commande) et pour définir les piles d'applications de manière reproductible.

Puisque les applications réelles sont généralement multi-conteneurs, et puisque Docker Compose est l'outil standard et largement utilisé pour les définir et les exécuter simplement (remplaçant l'orchestration manuelle fastidieuse par un seul fichier déclaratif et une commande), comprendre Docker Compose — ce qu'il résout, la structure du fichier compose et les commandes — est une connaissance précieuse et fréquemment appliquée pour travailler avec les applications multi-conteneurs, un compagnon quasi essentiel à Docker pour toute application conteneurisée non triviale et un outil omniprésent dans les flux de travail de développement.