Comment adapter les politiques de redémarrage Docker aux bases de données, aux processus de travail et aux applications Web

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Adaptez les politiques de redémarrage de Docker au cycle de vie du service et à la sémantique d’arrêt, plutôt que d’attribuer unless-stopped à chaque conteneur d’un fichier Compose.

Les politiques de redémarrage réagissent lorsque le processus principal d’un conteneur s’arrête ; une vérification de l’état de santé peut signaler qu’un processus toujours actif est défaillant sans le redémarrer automatiquement. Les bases de données, les workers, les applications web, les migrations et les tâches planifiées nécessitent donc des choix différents, selon qu’ils sont censés rester actifs, la signification d’un arrêt normal et la façon de signaler les échecs répétés.

Distinguer le comportement de redémarrage de l’état de santé et de la disponibilité

Une politique de redémarrage indique si Docker doit redémarrer un conteneur après l’arrêt de son processus. Une vérification de l’état de santé détermine si le service en cours d’exécution peut effectuer une opération définie. La disponibilité des dépendances indique si un autre service doit démarrer à ce stade. Ces mécanismes répondent à des problèmes connexes, mais différents.

Un article de 2026 sur la distinction entre état de santé et redémarrage explique cette séparation et montre comment les conditions d’état de santé de Compose peuvent retarder le démarrage des services dépendants jusqu’à ce qu’un service soit réellement prêt.

Ne vous attendez pas à ce que restart: always répare un processus web défaillant qui ne s’arrête jamais, ni à ce qu’une vérification de l’état de santé le redémarre à elle seule. Faites en sorte que l’application s’arrête lorsqu’il est dangereux de continuer, ajoutez un mécanisme de correction externe ou déclenchez une alerte en cas d’état de santé défaillant, selon la conception du service.

Utiliser des politiques de redémarrage persistantes pour les bases de données à longue durée de vie

On s’attend généralement à ce qu’une base de données sur un serveur domestique redémarre après le redémarrage de l’hôte ou du daemon Docker. unless-stopped constitue souvent un choix par défaut pratique si l’on veut respecter l’arrêt volontaire effectué par un administrateur ; always convient lorsque le redémarrage doit, par conception, annuler cet état d’arrêt manuel.

Un article de juillet 2026 sur les politiques de redémarrage qui suivent l’arrêt du processus détaille les différences entre no, on-failure, always et unless-stopped, et précise notamment que la politique réagit à l’arrêt du processus, pas à son état de santé.

La base de données a également besoin d’une véritable vérification de l’état de santé et d’un stockage persistant. Redémarrer PostgreSQL à répétition ne peut pas résoudre un disque plein, une configuration invalide, un état corrompu ou une migration incompatible. En cas de redémarrages répétés, déclenchez une alerte plutôt que de considérer cela comme une résilience réussie.

Choisir la politique du worker en fonction de la file d’attente et de la sémantique d’arrêt

Un worker de file d’attente à longue durée de vie peut justifier l’usage de unless-stopped s’il doit toujours traiter les tâches. Un worker à durée limitée ou un processus de traitement par lots peut utiliser on-failure:N afin que les erreurs temporaires donnent lieu à un nombre limité de nouvelles tentatives, tandis qu’un échec persistant entraîne un arrêt visible.

Une étude récente sur les tentatives de redémarrage limitées en cas d’échec souligne que le comportement des tentatives doit dépendre du fait qu’un processus est censé rester actif en permanence ou pouvoir se terminer normalement.

Sachez ce que signifie le code de sortie 0 pour l’image du worker. S’il signifie « tâche terminée », always peut transformer une tâche ponctuelle réussie en boucle sans fin. Si le worker est censé être un démon, une sortie inattendue, même propre, peut tout de même justifier un redémarrage automatique avec unless-stopped.

Garder les applications web actives sur la durée, mais les subordonner à leurs véritables dépendances

La plupart des applications web auto-hébergées sont conçues pour rester disponibles en continu ; unless-stopped est donc généralement plus facile à comprendre qu’une politique limitée aux échecs. Le paramètre de redémarrage ne dispense pas de s’assurer que la base de données, le cache, le DNS, les secrets et les chemins montés sont prêts.

Le diagnostic ZimaSpace associé sur les boucles de redémarrage dues aux dépendances des conteneurs explique pourquoi redémarrer sans cesse l’application visible peut masquer la défaillance initiale de la base de données, du cache, du montage, de la migration ou de la mémoire.

Utilisez des contrôles de santé des dépendances pour ordonner le démarrage lorsque c’est pertinent et limitez les nouvelles tentatives de l’application. Un service web qui plante toutes les cinq secondes jusqu’au démarrage de PostgreSQL est moins facile à surveiller qu’un service qui attend que la base soit prête et démarre proprement une seule fois.

Donner un cycle de vie défini aux migrations et aux tâches ponctuelles

Les conteneurs de migration, les outils d’importation, les tâches de maintenance et les tâches d’initialisation ponctuelles ne sont pas des démons ordinaires. Leur état de réussite est souvent « code de sortie 0 et arrêt définitif ». Utiliser always ou unless-stopped peut relancer involontairement une tâche terminée.

Gardez les outils opérationnels à exécution ponctuelle clairement identifiés au lieu de les laisser devenir des services permanents cachés. Une migration ou un outil d’importation doit avoir un état de réussite définitif qui reste visible après la fin de la commande.

Utilisez restart: "no" lorsqu’une défaillance doit entraîner un arrêt pour inspection, ou une politique on-failure avec un nombre limité de tentatives uniquement si la commande peut être relancée sans risque. Pour les migrations de schéma, vérifiez qu’une migration partiellement appliquée peut être relancée avant d’automatiser les nouvelles tentatives.

Tester la politique avec des modes de défaillance réels

Pour chaque service, testez une sortie normale du processus, un plantage avec code de sortie non nul, un redémarrage de l’hôte, un redémarrage du démon Docker, un arrêt manuel, un état non sain alors que le service est toujours actif et une dépendance indisponible. Consignez l’état attendu après chaque événement avant de déclarer la configuration résiliente.

Suivez le nombre de redémarrages et déclenchez une alerte lorsqu’il dépasse un faible seuil sur une période donnée. Le redémarrage automatique doit réduire le temps de récupération après une défaillance temporaire ; il ne doit pas rendre invisible un plantage persistant en générant un flux sans fin de nouveaux conteneurs.

Une bonne matrice de politiques est explicite : les bases de données et applications web à longue durée de vie redémarrent après les redémarrages de l’infrastructure, les workers démons récupèrent selon la sémantique de la file d’attente, les tâches finies s’arrêtent une fois terminées, et les contrôles de santé et de disponibilité révèlent les défaillances que la politique de redémarrage ne peut pas détecter.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.