Un alias Compose peut cesser de se résoudre après une recréation si le service rejoint un autre réseau propre au projet ou si l’alias n’y est plus rattaché.
Les alias Docker sont propres à un réseau, et non des noms globaux. La recréation d’une pile dans un nouveau répertoire, avec un nom de projet explicite, un nom de pile Portainer ou un projet Compose, peut créer un nouveau réseau par défaut alors qu’une autre application reste sur l’ancien. Le service peut être opérationnel et accessible via le port publié, alors que son alias interne ne fonctionne plus, car le conteneur appelant et la cible ne partagent plus le même réseau, ou parce qu’un proxy inverse a sélectionné un autre rattachement.
Comparez les anciens et les nouveaux noms de projet Compose
Notez les noms de projet précédent et actuel, le répertoire de travail, le nom de la pile, les noms des réseaux et les étiquettes des conteneurs. Comparez le service appelant et le service cible après leur recréation.
Docker Compose utilise le nom du projet pour regrouper et nommer les ressources. La priorité des noms de projet explique pourquoi le changement de répertoire ou de nom de déploiement peut créer un nouveau réseau au lieu de réutiliser l’ancien réseau du projet.
Si le conteneur appelant reste rattaché à oldproject_default tandis que la cible rejoint newproject_default, l’ancien alias n’a pas de portée DNS commune.
Vérifiez l’alias sur le réseau partagé exact
Inspectez les deux conteneurs et répertoriez chaque réseau auquel ils sont rattachés, ainsi que chaque point de terminaison, adresse IPv4 ou IPv6 et alias. Testez le DNS depuis l’intérieur du conteneur appelant.
La spécification Compose définit les alias comme des noms propres à un réseau ; un alias déclaré sous un réseau n’existe donc pas automatiquement sur un autre rattachement.
Déplacez la déclaration d’alias vers le réseau réellement partagé par les services. Ne vous fiez pas à container_name comme substitut à une découverte de services correctement configurée.
Vérifiez les noms des réseaux externes et la substitution lors du déploiement
Comparez la clé de réseau logique de Compose à son name externe explicite. Vérifiez la substitution des variables d’environnement et les variables de l’interface de la pile utilisées lors du déploiement.
La documentation de Portainer indique que les piles peuvent utiliser des réseaux Docker existants, qui doivent être sélectionnés de manière cohérente lorsque des piles déployées indépendamment doivent pouvoir se résoudre mutuellement.
Un réseau externe empêche les changements de préfixe de projet uniquement si toutes les piles référencent le même nom de réseau réel. Une faute de frappe peut créer ou sélectionner un autre réseau sans modifier le port publié par le service.
Confirmez que le conteneur appelant utilise le DNS de Docker plutôt qu’une adresse mise en cache
Effectuez une nouvelle résolution DNS depuis le conteneur appelant, examinez sa configuration de résolution et ne redémarrez que le processus qui met le DNS en cache, si nécessaire. Comparez la résolution de noms à la recherche directe du nom de service.
Le modèle des espaces de noms réseau de Linux isole les ressources réseau, c’est pourquoi la résolution DNS réussie sur l’hôte ne prouve pas que le conteneur client partage le réseau Docker de la cible.
N’ajoutez pas l’adresse IP actuelle du conteneur cible à /etc/hosts. Les conteneurs recréés peuvent recevoir une adresse différente, ce qui laisse une autre dépendance obsolète.
Vérifiez quel réseau utilise le proxy inverse
Inspectez les connexions réseau du proxy et de l’application, les labels du fournisseur et le réseau sélectionné pour le routage vers les backends. Testez l’alias depuis le conteneur du proxy.
Le fournisseur Docker de Traefik permet de spécifier le réseau Docker utilisé pour les connexions aux backends.
Si le proxy est connecté à plusieurs réseaux, la sélection automatique peut différer après la recréation. Définissez explicitement le réseau partagé voulu et conservez son nom réel.
Supprimez les points de terminaison obsolètes sans effacer le mauvais réseau
Répertoriez les conteneurs connectés aux anciens et aux nouveaux réseaux. Identifiez les points de terminaison orphelins, les conteneurs arrêtés et les services actifs qui dépendent encore de l’ancien réseau du projet.
Le guide de Red Hat sur la mise en réseau des conteneurs décrit la connexion des conteneurs à un réseau défini par l’utilisateur comme faisant partie de l’état d’exécution du conteneur, et non du contenu des fichiers de l’application.
Ne supprimez un ancien réseau qu’après avoir vérifié qu’aucune stack active ne l’utilise. Supprimer les deux réseaux et tout recréer d’un coup détruit les indices permettant de déterminer quelle connexion était incorrecte.
Recréez un service et vérifiez le DNS depuis chaque client
Normalisez le nom du projet ou du réseau externe, recréez uniquement le service concerné et testez le nom du service et l’alias depuis chaque conteneur dépendant.
L’article de ZimaSpace sur les dépendances de l’environnement d’exécution des conteneurs précise la règle connexe : un test de connectivité au niveau de l’hôte ne valide pas l’espace de noms du conteneur ni son chemin de découverte des services.
Le problème est résolu lorsque l’alias pointe vers le point de terminaison actuel depuis chaque client prévu, après la recréation de la stack et un redémarrage, sans adresses IP codées en dur.
Foire aux questions
Les alias de réseau Docker sont-ils globaux ?
Non. Un alias n’existe que sur le réseau où il est configuré et n’est utile qu’aux conteneurs qui partagent ce réseau.
Changer le nom du dossier Compose peut-il interrompre le DNS ?
Oui. Le dossier peut influer sur le nom de projet par défaut, qui détermine les noms de réseau générés, sauf si le nom du projet ou du réseau externe est fixé.
Dois-je utiliser container_name pour stabiliser le DNS ?
Généralement, non. Des noms de service stables et des réseaux partagés explicites permettent de conserver la mise à l’échelle de Compose et d’éviter les conflits de noms globaux.
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,...



