Un conteneur peut rester utilisable alors que sa vérification d’état échoue, car la sonde teste une commande, une adresse, un utilisateur ou une condition de disponibilité différente du chemin utilisé par votre navigateur.
Sur un serveur domestique, l’application peut s’ouvrir via un proxy inverse alors que Docker exécute la commande de vérification d’état dans le conteneur sur localhost, un utilitaire manquant, le mauvais port ou une dépendance temporairement indisponible. Commencez par reproduire la sonde exacte dans le conteneur, puis comparez sa cible et le résultat attendu avec le chemin réellement emprunté par l’utilisateur avant d’augmenter le nombre de tentatives ou de désactiver la vérification d’état.
Comparez ce que teste le navigateur avec ce que teste la vérification d’état
Notez l’URL et le chemin réseau qui permettent d’ouvrir l’application. Indiquez si le navigateur passe par un proxy inverse, un port publié sur l’hôte, une adresse IP locale ou le conteneur directement.
Docker exécute la sonde configurée dans le conteneur ; elle peut donc tester un point de terminaison différent de celui du navigateur. Un cas signalé dans la communauté Docker a montré qu’une vérification d’état échouait parce que l’image ne contenait pas la commande curl utilisée par la sonde, même si le processus du service pouvait toujours s’exécuter.
Si le chemin qui fonctionne dans le navigateur passe par un autre proxy ou port, ne considérez pas ce résultat comme une preuve que la cible de la sonde interne est correcte. Notez les deux chemins et identifiez le premier composant qui diffère.
Exécutez la commande exacte de vérification d’état dans le conteneur
Copiez exactement la commande de vérification d’état, y compris sa forme shell, son URL, ses options, ses identifiants et ses variables d’environnement. Exécutez-la dans le conteneur en cours d’exécution avec le même utilisateur et recueillez le code de sortie et la sortie.
Un conteneur déclaré non sain peut toujours avoir un processus en cours d’exécution, car l’état de santé reflète le résultat de la sonde, et non la possibilité pour les utilisateurs de charger une page. Le processus de diagnostic de Netdata distingue l’échec de la sonde de l’échec du processus avant toute modification du comportement de redémarrage.
Si la commande réussit manuellement, comparez l’utilisateur d’exécution, le shell, le répertoire de travail, l’environnement et le délai utilisés par la vérification automatique. Si elle échoue manuellement, l’erreur identifie maintenant la couche suivante, sans attendre un nouvel intervalle de vérification.
Vérifiez l’outil de sonde, le shell, le PATH et l’utilisateur
Vérifiez que chaque exécutable de la commande de vérification d’état existe dans l’image actuelle et peut être exécuté par l’utilisateur du conteneur. Les images minimales peuvent ne pas inclure curl, wget, bash, des outils DNS ou des magasins de certificats.
Les sondes au format shell et exec ne se comportent pas de la même façon. Les guillemets, les pipes, l’expansion des variables et les commandes composées nécessitent un shell disponible, tandis qu’une commande directe exige le chemin complet de l’exécutable lorsque l’environnement de la vérification d’état dispose d’un PATH limité.
Exécutez la commande avec un chemin absolu et l’utilisateur de service prévu. Corrigez l’image ou la sonde au lieu d’installer des outils de façon interactive, car une modification manuelle du conteneur disparaît à la prochaine reconstruction.
Vérifiez l’adresse interne, le port et le protocole
Examinez le service en écoute dans le conteneur et comparez-le à l’URL de la sonde. Un port hôte publié, comme 8080:80, ne signifie pas que le service écoute sur le port 8080 à l’intérieur du conteneur.
Les vérifications de l’état doivent tester l’état de l’application contrôlé par le conteneur. Le guide pratique de Dash0 indique qu’une sonde peut appeler un point de terminaison HTTP ou examiner un processus, mais que le point de terminaison doit refléter l’état de disponibilité réel du conteneur, plutôt qu’une route accessible uniquement par l’intermédiaire d’un proxy externe.
Testez 127.0.0.1, l’adresse d’écoute du conteneur et le nom du service uniquement lorsque chacun est approprié. Si l’application est uniquement liée à un socket Unix ou à une autre interface, modifiez la sonde pour qu’elle utilise le véritable point d’entrée interne.
Distinguez un démarrage lent d’une défaillance permanente
Mesurez le temps nécessaire avant que le bon point de terminaison réponde : démarrage de l’application, migration de la base de données, préchauffage du cache ou chargement du modèle. Comparez ce délai à start_period, interval, timeout et retries.
Compose peut bloquer les services dépendants lorsqu’une dépendance est toujours signalée comme non saine, même si elle devient opérationnelle par la suite. Une régression signalée de Compose a montré qu’un service ne devenait sain qu’après que l’échec de la dépendance avait déjà interrompu la pile, révélant une fenêtre de démarrage de la vérification de l’état trop courte.
N’augmentez les délais que lorsque les journaux prouvent que l’application progresse normalement. Des tentatives plus longues ne doivent pas masquer un port incorrect, une migration échouée, un certificat manquant ou une base de données inaccessible.
Gardez la sonde ciblée et vérifiez la reprise
Déterminez si la vérification de l’état doit refléter la vivacité du processus, la disponibilité locale de l’application ou une chaîne de dépendances plus profonde. Ne rendez pas un conteneur local défaillant simplement parce qu’une API externe facultative est indisponible.
Le guide ZimaSpace pour identifier la première dépendance en échec est la prochaine étape lorsque l’application ne peut pas être opérationnelle sans base de données, cache ou service réseau.
Le problème est résolu lorsque la sonde automatique exacte réussit après le démarrage normal, que le conteneur reste en bonne santé après le redémarrage de ses dépendances et que le véritable flux de travail de l’application reste disponible. La sonde doit être assez stricte pour détecter un service défaillant, mais assez ciblée pour éviter les échecs à tort dus à des systèmes sans rapport.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



