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.yamlpar 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é.
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.