Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Décrire une pile plutôt que la lancer

Décrire une pile plutôt que la lancer

Composer une pileintermediaire

Une application réelle n'est pas un conteneur : c'est une base de données, une API, un cache et un travailleur de fond, reliés par un réseau et par des volumes. Lancer tout cela à la main suppose de retenir l'ordre, les options de réseau, les noms de volumes et les variables d'environnement de chaque pièce. Compose remplace cette mémoire par un fichier.

# compose.yaml
services:
  api:
    build: .
    ports:
      - "3000:3000"
    environment:
      DB_URL: postgres://app@base:5432/app
  base:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: ${MDP_BASE}
    volumes:
      - donnees:/var/lib/postgresql/data

volumes:
  donnees:

Le fichier décrit un état, pas une suite d'actions. docker compose up -d amène le moteur dans cet état : il crée ce qui manque, laisse ce qui est déjà conforme et remplace ce dont la définition a changé. Relancer la commande deux fois de suite ne produit rien la seconde fois — c'est la propriété qui rend la pile reproductible.

Trois conséquences pratiques. Le fichier est versionné avec le code, donc une branche porte la pile dont elle a besoin. Il se relit, donc un nouvel arrivant comprend l'architecture sans interroger personne. Et il est comparable : un écart entre deux environnements devient un écart entre deux fichiers.

Les termes à connaître

Pile applicative

L'ensemble des conteneurs qui forment une application : le service web, la base de données, le cache, le travailleur de fond. Ils n'ont de sens qu'ensemble.

Compose

L'outil qui lit un fichier décrivant une pile et amène le moteur dans l'état décrit. Il s'invoque en sous-commande, docker compose, et jamais par l'ancien exécutable séparé.

Fichier Compose

Le fichier, nommé compose.yaml par défaut, qui déclare les services, les réseaux et les volumes de la pile. Il est versionné avec le code.

Déclaratif

Le style du fichier : on écrit l'état voulu, pas la suite de commandes pour y arriver. L'outil calcule la différence avec l'état courant.

Projet

Le regroupement logique des ressources d'une pile. Son nom, dérivé du répertoire par défaut, préfixe les conteneurs, les réseaux et les volumes créés.

Convergence

L'opération qui compare l'état décrit et l'état réel, puis ne recrée que les conteneurs dont la définition a changé.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.