Accueil › Docker & conteneurs › L'ordre de démarrage et la santé
L'ordre de démarrage et la santé
Composer une pileintermediaire
Déclarer qu'un service dépend d'un autre ordonne les lancements. Cela ne garantit rien sur la disponibilité.
services:
api:
build: .
depends_on:
- base # ⛔ attend le conteneur, pas le serveur
base:
image: postgres:16-alpine
Le conteneur de base démarre en quelques millisecondes. Le serveur qu'il contient met plusieurs secondes à accepter des connexions. L'API se lance dans cet intervalle et échoue sur une connexion refusée. Le symptôme est capricieux : cela passe sur un poste rapide, cela casse dans la chaîne d'intégration.
La forme correcte attache une condition à la dépendance, et un test de santé au service amont :
services:
api:
build: .
depends_on:
base:
condition: service_healthy
base:
image: postgres:16-alpine
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app"]
interval: 5s
timeout: 3s
retries: 5
start_period: 30s
Les deux pièces sont indissociables : la condition attend un état que seul le test sait mesurer. Sans test déclaré, l'état reste indéterminé et l'attente n'a rien à observer.
Une dernière chose, qui revient en entretien : cette condition n'est évaluée qu'au démarrage. Si la base tombe à midi, rien ne se produit du côté de l'API. L'application doit donc gérer la perte de connexion de toute façon.
Les termes à connaître
- Dépendance de démarrage
La déclaration
depends_on, qui ordonne le lancement d'un service après un autre. Sans condition, elle n'attend que le démarrage du conteneur.- Condition de santé
La forme
depends_onétendue qui attend un état précis du service amont : conteneur sain, ou conteneur terminé avec succès.- Test de santé
La commande exécutée périodiquement dans le conteneur pour décider s'il est sain. Elle est déclarée dans l'image ou dans le fichier Compose.
- Période de démarrage
Le délai initial pendant lequel les échecs du test ne comptent pas contre le service. Il couvre le temps d'amorçage sans masquer une panne durable.
- Réessai avec attente croissante
La stratégie côté application : retenter la connexion en espaçant les tentatives, au lieu de supposer la dépendance prête.
- Ordre d'arrêt
L'inverse de l'ordre de démarrage. Un service est arrêté avant ceux dont il dépend, ce qui ne garantit pas qu'il ait fini son travail en cours.
- Cycle de dépendances
Une chaîne de dépendances qui revient sur elle-même. Aucun ordre de démarrage n'existe alors, et la pile ne peut pas être lancée.
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.