Pourquoi un proxy inverse renvoie-t-il une erreur 502 après la reconstruction d’un conteneur ?

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.

Un proxy inverse renvoie une erreur 502 après la reconstruction d’un conteneur lorsqu’il ne parvient plus à établir une connexion valide avec la cible en amont reconstruite.

La reconstruction peut remplacer le conteneur, lui attribuer une nouvelle adresse, le détacher d’un réseau Docker ou renommer celui-ci, modifier le port exposé, restaurer une configuration incomplète ou démarrer le proxy avant que l’application ne soit prête. Pour établir le bon diagnostic, commencez par le journal d’erreurs du proxy et suivez l’adresse exacte de la cible en amont du proxy jusqu’au conteneur, au lieu de redémarrer les deux services jusqu’à ce que l’erreur disparaisse temporairement.

Confirmer que l’erreur 502 provient d’un échec de connexion à la cible en amont

Faites une requête vers le domaine concerné et notez l’horodatage, le statut du proxy, l’adresse de la cible en amont et le message d’erreur complet. Distinguez un refus de connexion, un nom d’hôte introuvable, un délai d’attente, une réinitialisation de connexion, un échec de négociation TLS et une réponse invalide.

Une erreur 502 signifie que le proxy n’a reçu aucune réponse exploitable de la cible en amont, mais les détails de l’erreur permettent de déterminer si la cible était absente, inaccessible, à l’écoute sur aucun port ou utilisait le mauvais protocole. Un guide de dépannage NGINX récent indique qu’un conteneur reconstruit peut laisser le proxy utiliser une ancienne adresse de backend jusqu’à l’actualisation de la résolution des noms ou de la configuration.

Testez directement l’application depuis l’hôte du proxy ou le conteneur du proxy, en utilisant le nom ou l’adresse, le port et le protocole de la cible indiqués dans le journal. Si cette requête directe échoue de la même manière, poursuivez l’investigation entre le proxy et le conteneur au lieu de modifier le DNS public ou les certificats.

Comparer la cible en amont avant et après la reconstruction

Inspectez le nom du conteneur reconstruit, le nom du service, l’adresse IP interne, le port exposé, le port publié, les alias réseau et les réseaux auxquels il est connecté. Comparez ces informations avec la configuration du proxy et sa dernière cible fonctionnelle.

Un problème signalé avec nginx-proxy décrit une reconstruction qui a modifié l’adresse IP du conteneur de l’application, alors que le proxy continuait d’envoyer les requêtes vers le conteneur en amont inaccessible. Le domaine public est resté correct ; seule l’identité privée de la cible en amont a changé.

Privilégiez un nom de service Compose stable ou un alias réseau plutôt qu’une adresse IP de conteneur. Si l’adresse IP est volontairement fixe, vérifiez que le service reconstruit l’a bien reçue et qu’aucun autre conteneur ne l’utilise désormais.

Vérifier que le proxy et l’application partagent toujours un réseau Docker

Listez les réseaux auxquels sont connectés le proxy et l’application, puis confirmez qu’ils partagent au moins un réseau défini par l’utilisateur. La publication d’un port hôte ne rend pas automatiquement le nom du conteneur accessible depuis un autre réseau Docker isolé.

Un cas de réseau Docker a montré que le déplacement d’un service dépendant vers le réseau approprié supprimait immédiatement les erreurs 502 récurrentes, illustrant ainsi un chemin vers le service en amont inaccessible même lorsque tous les conteneurs restent en cours d’exécution.

Reliez les services avec Compose plutôt qu’avec des commandes ponctuelles, afin que la configuration soit conservée après les reconstructions. Après avoir recréé la pile, testez la résolution DNS et le port du service en amont depuis le conteneur proxy.

Vérifier le port d’écoute interne et l’adresse d’écoute

Vérifiez que l’application écoute sur le port utilisé par le proxy et sur une adresse accessible depuis le réseau des conteneurs. Ne confondez pas un port publié sur l’hôte avec le port d’écoute interne du conteneur.

Le proxy ne peut se connecter que si l’application est à l’écoute au-delà de l’interface de bouclage. Un service à l’écoute sur 127.0.0.1 dans son propre conteneur est inaccessible au proxy, même si une commande de vérification locale réussit.

Examinez le journal de l’application, la liste des sockets et une requête directe depuis le conteneur proxy. Si le port refuse les connexions, corrigez l’écoute ou la configuration de l’application avant d’ajouter des tentatives ou d’augmenter les délais d’attente du proxy.

Attendre que l’application soit prête, et pas seulement que le conteneur démarre

Un conteneur reconstruit peut être en cours d’exécution alors que les migrations, la récupération de la base de données, le préchauffage du cache ou la génération de la configuration empêchent encore l’application d’accepter les requêtes. Comparez l’heure de la première erreur 502 avec les journaux de santé et de démarrage.

Une discussion sur le dépannage de Grist montre comment l’architecture Docker, les paramètres d’environnement et la disponibilité du service en amont peuvent entraîner des erreurs 502 persistantes côté conteneur après une reconstruction.

Ajoutez un contrôle de santé pertinent et faites attendre le proxy ou les services dépendants jusqu’à ce que l’opération nécessaire aux clients soit disponible, et pas seulement jusqu’à ce qu’un processus existe. Limitez le nombre de tentatives pour qu’une application définitivement en panne ne semble pas simplement en retard au démarrage.

Actualiser la résolution du proxy et reconstruire une configuration stable

Rechargez ou recréez le proxy une fois le nom du service, le réseau, le port et l’état de santé corrects. Si le proxy ne résout les noms qu’au démarrage, configurez une résolution dynamique prise en charge ou un ordre de redémarrage prévisible.

La procédure ZimaSpace pour isoler une dépendance de conteneur défaillante présente le diagnostic complémentaire lorsque le service en amont s’arrête sans cesse au lieu de rester opérationnel.

La réparation est complète uniquement lorsque le proxy résout le nom du service après une nouvelle reconstruction, atteint le port interne prévu, attend la fin du démarrage et sert le domaine sans modification manuelle des adresses IP. Après validation, supprimez les cibles temporaires utilisant directement des adresses IP et les connexions réseau non documentées.

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.