Dlaczego usługa Compose używa niewłaściwego pliku env dopiero po ponownym uruchomieniu hosta?

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.

Po ponownym uruchomieniu systemu usługa Compose może używać innych wartości środowiskowych, jeśli program uruchamiający podczas rozruchu wskazuje inny katalog projektu, plik env lub źródło wartości o wyższym priorytecie.

Polecenie ręczne może być uruchomione z docelowego folderu w jednym środowisku powłoki, podczas gdy systemd, harmonogram NAS lub Portainer uruchamia ten sam plik Compose po rozruchu systemu z innego kontekstu. Usługa może też ponownie uruchomić istniejący kontener, którego środowisko zostało ustalone podczas jego tworzenia, zamiast ponownie odczytać zmodyfikowany plik. Przed jednoczesną edycją kilku plików porównaj wyrenderowany model Compose i środowisko działającego procesu w ścieżce ręcznej oraz rozruchowej.

Porównaj środowisko uruchomionego procesu z docelowym plikiem

Zapisz identyfikator kontenera, czas jego utworzenia, obraz, etykiety Compose, nazwę projektu oraz rzeczywiste wartości widoczne w głównym procesie. Porównaj je z docelowym plikiem env, nie umieszczając sekretów we wspólnych dziennikach.

Środowisko procesu Linuksa ujawnia wartości przekazane podczas uruchamiania, co stanowi mocniejszy dowód niż odczyt pliku env, którego bieżący kontener mógł w ogóle nie użyć.

Jeśli kontener zawiera stare wartości i powstał przed wdrożeniem podczas ponownego uruchamiania systemu, usługa mogła go jedynie ponownie uruchomić. Jeśli kontener jest nowy, sprawdź kolejność pierwszeństwa i rozwiązywanie ścieżek.

Zastosuj prawidłową kolejność pierwszeństwa zmiennych środowiskowych Compose

Wypisz wszystkie źródła jednej nieszkodliwej zmiennej: flagi CLI, wartości powłoki, environment:, env_file:, domyślny lub jawnie wskazany plik .env oraz ENV obrazu.

Docker definiuje formalną kolejność pierwszeństwa zmiennych środowiskowych, dlatego poprawny plik env może przegrać z wartością o wyższym priorytecie, wstrzykniętą przez usługę rozruchową lub menedżera stosu.

Nie szukaj wyłącznie plików o powtarzających się nazwach. Sprawdź nazwę zmiennej w wyrenderowanym modelu Compose, pliku jednostki, ustawieniach menedżera, środowisku powłoki i domyślnych wartościach obrazu.

Sprawdź katalog projektu i ścieżki względne do plików env

Porównaj katalog roboczy polecenia ręcznego z katalogiem roboczym programu uruchamiającego podczas rozruchu, argumentami plików Compose, katalogiem projektu oraz względnymi odwołaniami env_file.

Specyfikacja Compose definiuje model aplikacji używany do rozwiązywania usług i konfiguracji, dlatego wybrana definicja projektu i jej ścieżki są elementami konfiguracji wdrożenia, a nie właściwościami ustalanymi ponownie na podstawie uruchomionego kontenera.

W przypadku plików środowiskowych wymaganych przy rozruchu używaj ścieżek bezwzględnych, jeśli narzędzie wdrożeniowe na to pozwala, albo jawnie ustaw katalog projektu i katalog roboczy, aby uruchomienia ręczne i automatyczne wskazywały te same pliki.

Sprawdź katalog roboczy systemd i pliki środowiskowe

Odczytaj efektywną jednostkę, wszystkie pliki uzupełniające, WorkingDirectory=, Environment=, EnvironmentFile= i ExecStart=. Porównaj jednostkę wczytywaną podczas rozruchu z poleceniem używanym ręcznie.

Ustawienia wykonywania systemd określają katalog roboczy usługi i pliki środowiskowe, które nie dziedziczą automatycznie bieżącego katalogu ani wyeksportowanych zmiennych z interaktywnej powłoki logowania.

Po zmianie jednostki lub pliku uzupełniającego przeładuj menedżera systemd i ponownie sprawdź efektywną jednostkę. Edycja szablonu lub nieużywanego pliku nie zmienia usługi faktycznie uruchamianej.

Sprawdź zmienne menedżera stosu i zapisany stan wdrożenia

Jeśli stosem zarządza Portainer lub interfejs NAS, porównaj zapisane zmienne, przesłany plik środowiskowy, ścieżkę wdrożenia Git, działanie aktualizacji przez webhook oraz wyświetlany model Compose.

Portainer rozróżnia sposób działania plików .env i stack.env, więc wartości wprowadzone w menedżerze mogą różnić się od tych w pliku edytowanym bezpośrednio na hoście.

Wybierz jedno źródło prawdy. Stosu zarządzanego z Git lub edytora internetowego nie należy też uruchamiać ręcznie z innej lokalnej kopii po każdym ponownym uruchomieniu.

Odtwórz kontener zamiast tylko go ponownie uruchamiać

Porównaj czas utworzenia kontenera z czasem edycji pliku env. Wyrenderuj zamierzoną konfigurację Compose, a następnie w kontrolowany sposób odtwórz tylko tę usługę, której dotyczy problem.

Wytyczne Red Hat dotyczące systemd zalecają sprawdzenie plików i zastąpień faktycznie używanych przez usługę przed jej ponownym uruchomieniem, aby zapobiec odtworzeniu kontenera ze starymi wartościami przez nieaktualną jednostkę lub skrypt opakowujący.

Ponowne uruchomienie kontenera nie odtwarza jego środowiska z Compose. Odtwórz go dopiero po zabezpieczeniu danych trwałych i potwierdzeniu, że wyrenderowany model wskazuje zamierzone woluminy i sekrety.

Zapewnij ten sam model przy ręcznym uruchomieniu, ponownym uruchomieniu i ponownym wdrożeniu

Przypnij pliki Compose, nazwę projektu, katalog projektu, ścieżkę do pliku env, właściciela stosu i zależność uruchamiania systemu. Zapisz wyrenderowaną konfigurację bez poufnych danych oraz nieszkodliwy odcisk środowiska.

Artykuł ZimaSpace o zakresie kopii zapasowej Dockera przedstawia powiązaną zasadę: pliki środowiskowe i definicje wdrożeń należy zachowywać razem z danymi trwałymi.

Problem zostaje rozwiązany, gdy ręczne odtworzenie, ponowne uruchomienie hosta, zaplanowana aktualizacja i ponowne wdrożenie przez menedżera stosu tworzą usługę z tym samym odfiltrowanym odcisku środowiska.

Często zadawane pytania

Czym różnią się pliki .env i env_file?

Plik projektu .env zwykle dostarcza wartości do interpolacji w Compose, podczas gdy plik env_file usługi dostarcza zmienne do kontenera. Ich wzajemne działanie i priorytety zależą od pełnego modelu Compose.

Czy ponowne uruchomienie kontenera wczytuje zmieniony plik env?

Nie. Wartości środowiskowe są ustawiane podczas tworzenia kontenera. Zazwyczaj trzeba odtworzyć usługę na podstawie poprawionej konfiguracji Compose.

Dlaczego problem pojawia się dopiero po ponownym uruchomieniu?

Ścieżka ponownego uruchamiania może korzystać z jednostki systemd, harmonogramu, zmiennych przechowywanych przez menedżera, innego katalogu roboczego lub starszej kopii pliku Compose, która różni się od konfiguracji użytej przy ręcznym uruchomieniu.

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.