Formations — 1 037 leçons en français

Accueil › Docker & conteneurs › Diagnostiquer un conteneur qui redémarre en boucle

Diagnostiquer un conteneur qui redémarre en boucle

Exploiter en productionavance

Un conteneur qui redémarre en boucle se diagnostique dans un ordre fixe. Chaque étape coûte une commande et élimine une famille de causes.

docker inspect --format '{{.State.Status}} {{.State.ExitCode}} {{.State.OOMKilled}} {{.RestartCount}}' api
docker logs --previous --tail 50 api   # ou : docker logs --tail 50 api

Les quatre étapes, dans l'ordre

  1. L'état et le code de sortie. Ils orientent avant toute lecture. Un code non nul dit que le processus s'est arrêté seul ; un indicateur de mémoire insuffisante dit que le noyau l'a tué.
  2. Les journaux de l'exécution précédente. C'est là qu'est la cause. Les journaux de l'instance en cours montrent un démarrage qui n'a pas encore échoué.
  3. La politique de redémarrage et son compteur. Elle explique le rythme, et son recul progressif explique pourquoi les redémarrages s'espacent.
  4. La vérification ciblée, choisie d'après les trois premières étapes.

Lire les codes de sortie

Code Signification la plus fréquente
0 le processus a terminé normalement — souvent une commande qui n'est pas un service
1 erreur applicative, la cause est dans les journaux
126 le fichier existe mais n'est pas exécutable
127 commande ou interpréteur introuvable dans l'image
137 processus tué par un signal d'arrêt immédiat, typiquement un manque de mémoire
143 processus arrêté par un signal de terminaison, donc de l'extérieur

Un code 0 en boucle n'est pas une panne : c'est une commande qui se termine avec une politique de redémarrage permanente.

Les termes à connaître

Code de sortie

L'entier renvoyé par le processus principal en s'arrêtant. Zéro signifie une fin normale ; tout le reste oriente le diagnostic avant même d'ouvrir les journaux.

Journaux de l'instance précédente

Les journaux de l'exécution qui vient d'échouer. Sans eux, on lit ceux du redémarrage en cours, qui ne contiennent pas encore la cause.

Recul progressif

L'allongement du délai entre deux redémarrages successifs. Il évite qu'un conteneur qui échoue instantanément sature la machine.

Arrêt pour mémoire insuffisante

Le noyau tue le processus quand le conteneur dépasse sa limite de mémoire. Le conteneur est marqué comme tel, et le code de sortie est celui d'un processus tué.

Sonde de vivacité mal réglée

Une sonde dont le délai initial ou le seuil est trop court. Elle tue un service en bon état qui démarre lentement, et produit une boucle que rien dans le code n'explique.

Point d'entrée de diagnostic

Le lancement d'une image avec une commande de remplacement — un interpréteur de commandes — pour l'inspecter sans exécuter le programme qui échoue.

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.