Panne / symptôme

Un conteneur Docker redémarre en boucle

Le conteneur démarre puis s’arrête et est relancé par sa politique restart.

ThématiqueLinux →
⌚ Environ 3 min de lecture
Voir mes favoris
Problème réel · V2

Vue diagnostic rapide

Ce que vous observez

Le conteneur démarre puis s’arrête et est relancé par sa politique restart.

Causes probables
  1. application crash
  2. variable/env incorrecte
  3. dépendance indisponible
Premiers contrôles
  1. Lire docker ps -a
  2. Lire logs
  3. Inspecter configuration
Actions recommandées
  1. Corriger configuration
  2. Réparer dépendance
  3. Désactiver restart le temps du diagnostic
Lancer Symptôme → Cause →
+
Afficher le guide détaillé completExplications détaillées et contenu de dépannage original.
Linux & DockerIntermédiaire

Le conteneur démarre puis s’arrête et est relancé par sa politique restart.

Important : relevez toujours le message d’erreur exact et l’heure du problème avant de modifier la configuration. Les actions proposées doivent être adaptées à votre environnement.

Causes probables

  • application crash
  • variable/env incorrecte
  • dépendance indisponible

Diagnostic étape par étape

  1. 1

    Lire docker ps -a

    Observer Exit Code.

  2. 2

    Lire logs

    Identifier première erreur.

  3. 3

    Inspecter configuration

    Volumes, variables, healthcheck.

Commandes utiles

docker ps -a
docker logs --tail 200 CONTAINER

Solutions possibles

  • Corriger configuration
  • Réparer dépendance
  • Désactiver restart le temps du diagnostic
Quand escalader ?

Escalader si le conteneur contient des données non persistées.

Validation du diagnostic

Pour « Un conteneur Docker redémarre en boucle », relevez le nom du conteneur, son image, le code de sortie, le nombre de redémarrages et les dernières lignes de log. Vérifiez aussi la politique de restart et les dépendances externes ; une boucle peut être la conséquence normale d’un processus principal qui s’arrête immédiatement.

Test discriminant

Inspectez le conteneur et ses logs, puis lancez si possible l’image avec une commande de diagnostic ou une configuration minimale. Contrôlez volumes, secrets, variables d’environnement, ports et santé des services dépendants. Comparez l’image ou la configuration avec la dernière exécution connue comme fonctionnelle.

Critère de résolution

Validez la correction lorsque le conteneur reste en état attendu au-delà de plusieurs intervalles de restart et que son healthcheck, s’il existe, devient sain. Vérifiez également les logs après redémarrage du daemon ou de l’hôte afin de confirmer que la stabilité ne dépend pas d’un état transitoire.

Concepts liés

Référence primaire : Docker Docs — Troubleshooting the Docker daemon.

♡ 0