Lista kontrolna przeglądu zmian w Docker Compose dotyczących woluminów, sieci i sekretów

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.

Bezpieczne podejście polega na tym, by traktować przegląd wyrenderowanej konfiguracji i odwracalną kontrolę wdrożenia, chroniące ścieżki danych, dostępność sieci i sekrety, jako sekwencję możliwych do zaobserwowania punktów kontrolnych, a nie pojedyncze polecenie.

W przypadku stosu aplikacji Docker Compose na serwerze domowym praktycznym zagrożeniem jest to, że edycja Compose może spowodować ponowne utworzenie kontenerów z innym trwałym magazynem danych, łącznością lub sposobem przekazywania sekretów. Zapisz bieżącą tożsamość i punkt odzyskiwania, zacznij od najmniej inwazyjnego testu rozróżniającego, zinterpretuj wyniki pozytywne i negatywne przed zmianą kolejnej zmiennej i zatrzymaj się, jeśli magazyn danych staje się niestabilny lub ujawniona zostałaby jedyna kopia możliwa do odzyskania. Procedura kończy się dopiero wtedy, gdy pierwotne obciążenie działa poprawnie albo zebrane dowody wskazują na konieczność eskalacji.

Wyrenderuj efektywną konfigurację przed przeglądem

Ustal zestaw plików Compose, nazwę projektu, katalog roboczy, pliki środowiskowe, profile i tagi obrazów używane przez działające wdrożenie. Uruchom docker compose config w sposób, który nie ujawnia wartości sekretów, bezpiecznie zapisz wyrenderowany model i porównaj go z ostatnim znanym, poprawnym wdrożeniem.

Działanie Compose zależy od interpolacji i scalonych plików, dlatego przegląd samego edytowanego YAML-a może nie ujawnić faktycznej zmiany. Zalecany przegląd wyrenderowanej konfiguracji Compose obejmuje sprawdzenie rozstrzygniętej konfiguracji i planu wdrożenia, dzięki czemu przegląd staje się porównaniem działania w czasie wykonywania, a nie ćwiczeniem z formatowania.

Zatrzymaj się, jeśli zmienne nie są ustawione, nazwa projektu zmieniła się nieoczekiwanie, tagi obrazów są zmienne i nie zapisano ich skrótów ani wyrenderowany plik zawiera dane logowania. Rozwiąż te problemy przed wykonaniem jakiegokolwiek polecenia pull, build lub up.

Prześledź wszystkie trwałe wolumeny i montowania wiązane

Dla każdej usługi przypisz ścieżkę docelową kontenera do nazwanego wolumenu lub ścieżki hosta, określ, czy przechowuje ona konfigurację, pliki bazy danych, przesłane pliki czy pamięć podręczną, i sprawdź, czy źródło istnieje oraz ma oczekiwanego właściciela. Zwróć szczególną uwagę na ścieżki względne, ponieważ zmieniony katalog roboczy może po cichu wskazywać nowy, pusty folder.

Porównaj jawne nazwy wolumenów i flagi zewnętrzne z aktualnym wykazem wolumenów Dockera. Zmiana nazwy projektu może utworzyć nowy wolumen z prefiksem, pozostawiając stare dane bez zmian, przez co aplikacja może wyglądać na zresetowaną. Przed ponownym utworzeniem wykonaj kopię zapasową danych przechowujących stan i zapisz bieżący wynik inspekcji wolumenów.

Powiązany artykuł ZimaSpace dotyczący ochrony trwałej konfiguracji aplikacji podczas aktualizacji omawia utratę konfiguracji podczas aktualizacji aplikacji. Skorzystaj z niego, jeśli przegląd wykaże, że trwały stan aplikacji nigdy nie został prawidłowo oddzielony; nie maskuj problemu, kopiując nieznane pliki do nowo utworzonego woluminu.

Sprawdź sieci, porty i sposób udostępniania sekretów

Porównaj nazwy sieci, aliasy, rodziny adresów IP, opublikowane porty, powiązania z interfejsami hosta i cele odwrotnego proxy. Potwierdź, że bazy danych pozostają prywatne, proxy nadal może rozwiązać nazwę usługi aplikacji i po zmianie żaden port administracyjny nie będzie dostępny na wszystkich interfejsach.

Dla każdego sekretu zapisz jego źródło, odbiorcę, ścieżkę montowania lub klucz zmiennej środowiskowej, tryb uprawnień pliku i osobę odpowiedzialną za rotację, ale nie zapisuj jego wartości. Upewnij się, że nowa konfiguracja odwołuje się do istniejącego zabezpieczonego pliku lub sekretu zewnętrznego oraz że sekret nie jest ujawniany w logach, argumentach budowania, etykietach ani wyrenderowanym diffie.

Zmiana sieci lub sekretu przechodzi przegląd tylko wtedy, gdy zamierzony odbiorca może uzyskać do niej dostęp lub ją odczytać, a niezamierzeni odbiorcy nie mogą. Jeśli zmiana wymaga jednoczesnej rotacji poświadczeń, podziel wdrożenie na etap nakładania się poświadczeń i etap unieważniania zamiast łączyć oba etapy w jednym, nieodwracalnym restarcie.

Przygotuj odtworzenie i sprawdź możliwość wycofania zmian

Pobierz obrazy i sprawdź proponowane zmiany usług przed uruchomieniem stosu. Wdróż zmianę w oknie serwisowym, najpierw odtwórz jedną zależność niskiego ryzyka, jeśli pozwala na to architektura, a następnie przed dalszymi działaniami obserwuj kontrole stanu, logi, montowania, rozwiązywanie nazw DNS i opublikowane gniazda.

Przetestuj logowanie, jeden odczyt danych, jeden tymczasowy zapis, zadania działające w tle i dostęp przez odwrotne proxy. Uruchom stos ponownie, aby potwierdzić, że odwołania do woluminów i sekretów przetrwają odtworzenie procesów. Nie uznawaj zmiany za udaną tylko dlatego, że kontenery mają status „uruchomiony”.

Zachowaj poprzednie pliki Compose, odwołania do zmiennych środowiskowych, skróty obrazów i kopię zapasową danych, dopóki kontrole akceptacyjne nie zakończą się pomyślnie. Natychmiast przywróć poprzednią wersję, jeśli aplikacja uruchomi się z pustymi danymi, baza danych zostanie nieoczekiwanie zmigrowana, zabraknie sekretu lub port administratora będzie dostępny z zewnątrz; przeprowadź analizę na podstawie zapisanego wyrenderowanego diffu.

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.