Dlaczego alias sieci Compose przestaje być rozpoznawany po ponownym utworzeniu stosu pod nową nazwą projektu?

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Alias Compose może przestać być rozpoznawany po ponownym utworzeniu stosu, jeśli usługa zostanie podłączona do innej sieci przypisanej do projektu albo alias przestanie być przypisany do tej sieci.

Aliasy Docker są przypisane do sieci, a nie globalne. Ponowne utworzenie stosu w nowym katalogu lub pod inną jawną nazwą projektu, nazwą stosu Portainera albo nazwą projektu Compose może utworzyć nową domyślną sieć, podczas gdy inna aplikacja pozostanie podłączona do starej. Usługa może działać poprawnie i być dostępna przez opublikowany port, a mimo to jej alias wewnętrzny nie będzie działać, ponieważ kontener wywołujący i docelowy nie są już podłączeni do tej samej sieci albo odwrotne proxy wybrało inne połączenie sieciowe.

Porównaj poprzednią i nową nazwę projektu Compose

Zapisz poprzednią i bieżącą nazwę projektu, katalog roboczy, nazwę stosu, nazwy sieci i etykiety kontenerów. Po ponownym utworzeniu porównaj usługę wywołującą z docelową.

Docker Compose używa nazwy projektu do grupowania zasobów i nadawania im nazw. Kolejność pierwszeństwa nazwy projektu wyjaśnia, dlaczego zmiana katalogu lub nazwy wdrożenia może spowodować utworzenie nowej sieci zamiast ponownego użycia starej sieci projektu.

Jeśli kontener wywołujący nadal jest podłączony do oldproject_default, a docelowy do newproject_default, poprzedni alias nie jest dostępny w ich wspólnym zakresie DNS.

Zweryfikuj alias w dokładnie tej samej współdzielonej sieci

Sprawdź oba kontenery i wyświetl wszystkie podłączone sieci, punkty końcowe, adresy IPv4 lub IPv6 oraz aliasy. Przetestuj DNS z poziomu kontenera wywołującego.

Specyfikacja Compose określa, że aliasy są nazwami przypisanymi do konkretnej sieci, więc alias zadeklarowany dla jednej sieci nie jest automatycznie dostępny w ramach innego połączenia sieciowego.

Przenieś deklarację aliasu do sieci faktycznie współdzielonej przez usługi. Nie polegaj na container_name jako zamienniku celowo skonfigurowanego wykrywania usług.

Sprawdź nazwy sieci zewnętrznych i podstawianie zmiennych podczas wdrażania

Porównaj logiczny klucz sieci Compose z jawną wartością name ustawioną dla sieci zewnętrznej. Sprawdź podstawianie zmiennych środowiskowych i zmienne interfejsu stosu używane podczas wdrażania.

Dokumentacja Portainera wyjaśnia, że stosy mogą korzystać z istniejących sieci Docker, które należy wybierać konsekwentnie, gdy niezależnie wdrażane stosy muszą wzajemnie rozpoznawać swoje nazwy.

Sieć zewnętrzna zapobiega zmianom prefiksu projektu tylko wtedy, gdy wszystkie stosy odwołują się do tej samej rzeczywistej nazwy sieci. Literówka może spowodować utworzenie lub wybranie innej sieci bez zmiany opublikowanego portu usługi.

Potwierdź, że kontener wywołujący korzysta z DNS Dockera, a nie z buforowanego adresu

Uruchom świeże wyszukiwanie DNS z kontenera wywołującego, sprawdź jego konfigurację resolvera i w razie potrzeby zrestartuj tylko proces buforujący DNS. Porównaj rozwiązywanie nazw z bezpośrednim wyszukiwaniem nazwy usługi.

Model przestrzeni nazw sieciowych w Linuksie izoluje zasoby sieciowe, dlatego poprawne rozwiązywanie nazw DNS na hoście nie dowodzi, że kontener klienta współdzieli sieć Docker z kontenerem docelowym.

Nie dodawaj bieżącego adresu IP celu do pliku /etc/hosts. Odtworzone kontenery mogą otrzymać inny adres, przez co powstanie kolejna nieaktualna zależność.

Sprawdź, z której sieci korzysta serwer proxy

Sprawdź podłączenia serwera proxy i aplikacji do sieci, etykiety dostawcy oraz sieć wybraną do routingu ruchu do zaplecza. Przetestuj alias z kontenera serwera proxy.

Dostawca Docker w Traefik umożliwia określenie sieci Docker używanej do połączeń z zapleczem.

Jeśli serwer proxy jest podłączony do kilku sieci, po ponownym utworzeniu automatyczny wybór może być inny. Jawnie ustaw zamierzoną współdzieloną sieć i zachowaj jej rzeczywistą nazwę.

Usuń nieaktualne punkty końcowe, nie usuwając niewłaściwej sieci

Wyświetl listę kontenerów podłączonych do starej i nowej sieci. Znajdź osierocone punkty końcowe, zatrzymane kontenery i aktywne usługi, które nadal korzystają ze starej sieci projektu.

Przewodnik Red Hat dotyczący sieci kontenerowych opisuje podłączanie kontenerów do sieci zdefiniowanej przez użytkownika jako element stanu środowiska uruchomieniowego kontenera, a nie zawartości plików aplikacji.

Usuń starą sieć dopiero po upewnieniu się, że nie korzysta z niej żaden aktywny stos. Usunięcie obu sieci i ponowne utworzenie wszystkiego naraz niszczy dowody wskazujące, które podłączenie było nieprawidłowe.

Utwórz ponownie jedną usługę i zweryfikuj DNS z każdego klienta

Ujednolić nazwę projektu lub sieć zewnętrzną, ponownie utworzyć tylko usługę, której dotyczy problem, i przetestować nazwę usługi oraz alias z każdego zależnego kontenera.

Artykuł ZimaSpace o zależnościach środowiska uruchomieniowego kontenerów przedstawia pokrewną zasadę: test łączności na poziomie hosta nie weryfikuje przestrzeni nazw kontenera ani ścieżki wykrywania usług.

Problem jest rozwiązany, gdy alias wskazuje bieżący punkt końcowy ze wszystkich zamierzonych klientów po ponownym utworzeniu stosu i ponownym uruchomieniu, bez używania zakodowanych na stałe adresów IP.

Często zadawane pytania

Czy aliasy sieci Docker są globalne?

Nie. Alias istnieje tylko w sieci, w której został skonfigurowany, i jest przydatny tylko dla kontenerów współdzielących tę sieć.

Czy zmiana nazwy folderu Compose może zakłócić działanie DNS?

Tak. Nazwa folderu może wpływać na domyślną nazwę projektu, a ta wpływa na generowane nazwy sieci, chyba że ustalono nazwę projektu lub sieci zewnętrznej.

Czy używać container_name, aby zapewnić stabilność DNS?

Zazwyczaj nie. Stabilne nazwy usług i jawnie współdzielone sieci zachowują możliwość skalowania w Compose i zapobiegają kolizjom nazw globalnych.

Wsparcie i porady

Więcej do przeczytania

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.