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
- 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é.
- 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é.
- La politique de redémarrage et son compteur. Elle explique le rythme, et son recul progressif explique pourquoi les redémarrages s'espacent.
- 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.
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.