Formations — 1 037 leçons en français

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.

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.