Warum wird ein Compose-Netzwerk-Alias nach dem Neuerstellen des Stacks unter einem neuen Projektnamen nicht mehr aufgelöst?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Ein Compose-Alias kann nach einer Neuerstellung nicht mehr aufgelöst werden, wenn der Dienst einem anderen projektspezifischen Netzwerk beitritt oder der Alias dort nicht mehr eingebunden ist.

Docker-Aliase gelten netzwerkbezogen, nicht global. Wird ein Stack in einem neuen Verzeichnis, mit einem expliziten Projektnamen, einem anderen Portainer-Stack-Namen oder als anderes Compose-Projekt neu erstellt, kann ein neues Standardnetzwerk entstehen, während eine andere App weiterhin mit dem alten verbunden ist. Der Dienst kann gesund und über seinen veröffentlichten Port erreichbar sein, während sein interner Alias fehlschlägt, weil sich der aufrufende Container und das Ziel nicht mehr dasselbe Netzwerk teilen oder weil ein Reverse-Proxy eine andere Netzwerkanbindung ausgewählt hat.

Alte und neue Compose-Projektnamen vergleichen

Vorherigen und aktuellen Projektnamen, Arbeitsverzeichnis, Stack-Namen, Netzwerknamen und Container-Labels erfassen. Den aufrufenden Container und den Zieldienst nach der Neuerstellung vergleichen.

Docker Compose verwendet den Projektnamen, um Ressourcen zu gruppieren und zu benennen. Die Vorrangregeln für Projektnamen erklären, warum eine Änderung des Verzeichnisses oder Bereitstellungsnamens ein neues Netzwerk erstellen kann, anstatt das alte Projektnetzwerk wiederzuverwenden.

Bleibt der aufrufende Container mit oldproject_default verbunden, während das Ziel dem Netzwerk newproject_default beitritt, liegt der frühere Alias nicht mehr im gemeinsamen DNS-Bereich.

Den Alias im genau gemeinsam genutzten Netzwerk überprüfen

Beide Container überprüfen und alle angebundenen Netzwerke, Endpunkte, IPv4- oder IPv6-Adressen sowie Aliase auflisten. DNS im aufrufenden Container testen.

Die Compose-Spezifikation definiert Aliase als netzwerkbezogene Namen. Ein unter einem Netzwerk deklarierter Alias ist daher nicht automatisch über eine andere Netzwerkanbindung verfügbar.

Die Aliasdeklaration auf das Netzwerk verschieben, das die Dienste tatsächlich gemeinsam nutzen. container_name nicht als Ersatz für gezielte Diensterkennung verwenden.

Externe Netzwerknamen und Ersetzungen bei der Bereitstellung überprüfen

Den logischen Compose-Netzwerkschlüssel mit dem expliziten externen name vergleichen. Umgebungsvariablen-Ersetzungen und Stack-UI-Variablen prüfen, die bei der Bereitstellung verwendet werden.

Portainer dokumentiert, dass Stacks vorhandene Docker-Netzwerke verwenden können. Diese müssen einheitlich ausgewählt werden, wenn unabhängig bereitgestellte Stacks einander auflösen müssen.

Ein externes Netzwerk verhindert Änderungen am Projektpräfix nur dann, wenn jeder Stack denselben tatsächlichen Netzwerknamen verwendet. Ein Tippfehler kann ein anderes Netzwerk erstellen oder auswählen, ohne den veröffentlichten Port des Dienstes zu ändern.

Single board computer zimaboard2

Bestätigen, dass der aufrufende Container Docker-DNS statt einer zwischengespeicherten Adresse verwendet

Führe vom aufrufenden Container aus eine neue DNS-Abfrage durch, prüfe dessen Resolver-Konfiguration und starte bei Bedarf nur den Prozess neu, der DNS zwischenspeichert. Vergleiche die Namensauflösung mit einer direkten Abfrage des Dienstnamens.

Das Netzwerk-Namespace-Modell von Linux isoliert Netzwerkressourcen. Deshalb beweist eine erfolgreiche DNS-Auflösung auf dem Host nicht, dass der aufrufende Container dasselbe Docker-Netzwerk wie das Ziel nutzt.

Fügen Sie die aktuelle Container-IP des Ziels nicht zu /etc/hosts hinzu. Neu erstellte Container können eine andere Adresse erhalten, wodurch eine weitere veraltete Abhängigkeit entsteht.

Überprüfen Sie, welches Netzwerk der Reverse-Proxy verwendet

Überprüfen Sie die Netzwerkanbindungen von Proxy und Anwendung, die Provider-Labels sowie das für das Backend-Routing ausgewählte Netzwerk. Testen Sie den Alias vom Proxy-Container aus.

Der Docker-Provider von Traefik unterstützt die Angabe des Docker-Netzwerks für Backend-Verbindungen.

Wenn der Proxy mit mehreren Netzwerken verbunden ist, kann die automatische Auswahl nach dem Neuerstellen anders ausfallen. Legen Sie das vorgesehene gemeinsam genutzte Netzwerk explizit fest und sorgen Sie dafür, dass sein tatsächlicher Name stabil bleibt.

Veraltete Endpunkte entfernen, ohne das falsche Netzwerk zu löschen

Listen Sie die mit den alten und neuen Netzwerken verbundenen Container auf. Ermitteln Sie verwaiste Endpunkte, gestoppte Container und aktive Dienste, die noch vom alten Projektnetzwerk abhängen.

Der Leitfaden zur Container-Vernetzung von Red Hat beschreibt die Anbindung von Containern an benutzerdefinierte Netzwerke als Teil des Laufzeitzustands des Containers und nicht als Inhalt von Anwendungsdateien.

Entfernen Sie ein altes Netzwerk erst, nachdem Sie sich vergewissert haben, dass kein aktiver Stack es verwendet. Wenn Sie beide Netzwerke löschen und alles auf einmal neu erstellen, gehen die Hinweise darauf verloren, welcher Netzwerkanschluss falsch war.

Einen Dienst neu erstellen und DNS von jedem aufrufenden Container aus überprüfen

Standardisieren Sie den Projektnamen oder das externe Netzwerk, erstellen Sie nur den betroffenen Dienst neu und testen Sie den Dienstnamen und Alias von jedem abhängigen Container aus.

Der ZimaSpace-Artikel zu Abhängigkeiten der Container-Laufzeitumgebung liefert die ergänzende Regel: Ein Verbindungstest auf Host-Ebene überprüft nicht den Namespace und den Dienstermittlungspfad eines Containers.

Das Problem ist behoben, wenn der Alias nach dem Neuerstellen und Neustarten des Stacks von jedem vorgesehenen aufrufenden Container aus zum aktuellen Endpunkt aufgelöst wird, ohne fest codierte IP-Adressen.

Häufig gestellte Fragen

Sind Docker-Netzwerk-Aliase global?

Nein. Ein Alias gilt nur für das Netzwerk, für das er konfiguriert ist, und ist nur für Container nützlich, die dieses Netzwerk gemeinsam nutzen.

Kann eine Änderung des Compose-Ordnernamens DNS beeinträchtigen?

Ja. Der Ordner kann den Standard-Projektnamen beeinflussen, der sich wiederum auf generierte Netzwerknamen auswirkt, sofern der Projektname oder der Name des externen Netzwerks nicht festgelegt ist.

Sollte ich container_name verwenden, damit DNS stabil bleibt?

Normalerweise nicht. Stabile Dienstnamen und explizite gemeinsam genutzte Netzwerke sorgen dafür, dass die Compose-Skalierung erhalten bleibt und keine globalen Namenskollisionen entstehen.

Support und Tipps

Mehr zum Lesen

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.