Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Arrêter un conteneur : signaux et codes de sortie

Arrêter un conteneur : signaux et codes de sortie

Exécuter un conteneurdebutant

docker stop n'arrête pas brutalement. Il procède en deux temps.

  1. Il envoie au processus principal le signal de terminaison : une demande d'arrêt, que le programme peut intercepter.
  2. Il attend le délai de grâce — dix secondes par défaut.
  3. Si le processus est toujours là, il envoie le signal fatal, qui ne se discute pas.
docker stop api            # délai par défaut
docker stop -t 30 api      # trente secondes pour finir
docker kill api            # signal fatal immédiat, aucun délai

Ce que l'application doit faire

Intercepter la demande, et sortir proprement :

process.on("SIGTERM", () => {
  serveur.close(async () => {     // 1. ne plus accepter de requête
    await pool.end();             // 2. fermer les connexions à la base
    process.exit(0);              // 3. sortir avec succès
  });
});

En Java, le mécanisme équivalent est un crochet d'arrêt enregistré auprès de la machine virtuelle ; Spring Boot sait le faire pour vous, à condition d'activer l'arrêt en douceur.

Le code de sortie raconte l'histoire

docker inspect -f '{{.State.ExitCode}}' api

Zéro, c'est un succès. Et un processus tué par un signal rend 128 plus le numéro du signal : 143 pour une terminaison honorée, 137 pour le signal fatal. Voir 137 après un docker stop signifie que le délai a expiré — donc que l'arrêt propre n'a pas eu lieu.

Les termes à connaître

Signal de terminaison

Le signal poli envoyé par docker stop. Il demande au processus de s'arrêter et lui laisse le temps de le faire. Un programme peut l'intercepter.

Délai de grâce

Le temps accordé entre le signal de terminaison et le signal fatal. Dix secondes par défaut, réglable avec l'option de délai.

Signal fatal

Le signal qui termine le processus immédiatement. Il ne peut être ni intercepté ni ignoré : rien n'est fermé proprement.

Arrêt propre

Fermer l'écoute, laisser finir les requêtes en vol, fermer les connexions à la base, puis sortir — dans cet ordre.

Code de sortie

L'entier rendu par le processus principal. Zéro signifie succès ; toute autre valeur signale un échec, et c'est lui que la politique de redémarrage examine.

STOPSIGNAL

L'instruction de recette qui change le signal envoyé par l'arrêt, pour les programmes qui n'utilisent pas la convention habituelle.

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.