Proces migracji woluminu nazwanego Dockera między dwoma serwerami domowymi

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 potraktować archiwum utworzone po zatrzymaniu procesów zapisujących dane lub zsynchronizowaną kopię w jawnie wskazanym wolumenie docelowym, a następnie weryfikację sum kontrolnych i aplikacji, jako sekwencję etapów z możliwymi do zaobserwowania wynikami, a nie pojedyncze polecenie.

W przypadku dwóch serwerów domowych z systemem Linux i Docker Compose praktyczne ryzyko polega na konieczności przeniesienia kontenera przechowującego stan na inny host bez kopiowania wolumenu, który jest używany lub został nieprawidłowo nazwany. 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 oraz zatrzymaj się, gdy pamięć staje się niestabilna lub jedyna możliwa do odzyskania kopia byłaby narażona. Opisany niżej proces kończy się dopiero wtedy, gdy pierwotne obciążenie działa poprawnie albo zebrane dowody wyznaczają granicę wymagającą eskalacji.

Zidentyfikuj konfigurację wolumenu źródłowego i docelowego

Zapisz skrót obrazu kontenera źródłowego, nazwę projektu Compose, usługę, klucz wolumenu, rzeczywistą nazwę wolumenu Docker, miejsce montowania, sterownik wolumenu i wersję aplikacji. Użyj poleceń docker inspect i docker volume inspect; nie wyciągaj wniosków o fizycznej ścieżce wyłącznie na podstawie etykiety YAML.

Compose zwykle dodaje nazwę projektu jako prefiks do nazwanych wolumenów, chyba że użyto jawnej nazwy lub wolumenu zewnętrznego. Na hoście docelowym wygeneruj konfigurację Compose i jawnie utwórz odpowiedni pusty wolumen, aby podczas migracji dane nie trafiły do jednego wolumenu, a usługa nie została uruchomiona z innym.

Jeśli wolumen zawiera bazę danych, użyj jej natywnego zrzutu lub obsługiwanej kopii zapasowej jako podstawowej, przenośnej metody odzyskiwania, a kopię wolumenu traktuj jako punkt odzyskiwania dla tej samej wersji. Zatrzymaj się, jeśli sterownik jest zdalny, pamięć źródłowa jest niestabilna albo stan aplikacji obejmuje dodatkowe wolumeny nieuwzględnione w tym zakresie.

Zatrzymaj procesy zapisujące dane i utwórz kopię zachowującą metadane

Włącz tryb konserwacji aplikacji, zatrzymaj zadania działające w tle, a następnie prawidłowo zatrzymaj aplikację i bazę danych. Potwierdź, że żaden kontener nie montuje wolumenu w trybie odczytu i zapisu. Utwórz archiwum za pomocą tymczasowego kontenera albo użyj kontrolowanej kopii systemu plików, która zachowuje numeryczne identyfikatory właścicieli, uprawnienia, dowiązania symboliczne, atrybuty rozszerzone, jeśli są potrzebne, oraz pliki rzadkie.

Niezależny poradnik dotyczący migracji wolumenów Docker za pomocą rsync pokazuje, jak przenieść dane wolumenu Docker przy użyciu rsync. Kluczowe jest to, aby źródło nie było w użyciu, a polecenie kopiowania operowało na zawartości zidentyfikowanego wolumenu, zamiast bezkrytycznie manipulować katalogiem wewnętrznym Dockera, gdy demon z niego korzysta.

Utwórz manifest zawierający liczbę plików, łączną liczbę bajtów, reprezentatywne sumy kontrolne i sumę kontrolną archiwum. Pozostaw źródłowy wolumin i natywną kopię zapasową bez zmian; etap kopiowania można uznać za zakończony pomyślnie tylko wtedy, gdy plik transferu jest czytelny na hoście docelowym.

Przywróć dane do jawnie wskazanego woluminu docelowego

Sprawdź pojemność systemu plików hosta docelowego, dostępność i-węzłów, oczekiwane wartości UID i GID oraz zgodność wersji obrazu aplikacji. Przywróć archiwum do pustego woluminu docelowego, nie spłaszczając jego struktury katalogów najwyższego poziomu, a następnie porównaj właścicieli, liczbę plików, rozmiary i wybrane sumy kontrolne.

Dyskusja społeczności dotycząca przypadku niepowodzenia migracji nazwanego woluminu pokazuje, dlaczego bezpośrednie zastępowanie plików w wewnętrznych katalogach woluminów Dockera może się nie powieść lub pozostawić niejasny stan. Użyj środowiska uruchomieniowego, aby zamontować wolumin w kontenerze pomocniczym i przeprowadzić przywracanie za pośrednictwem tego kontrolowanego interfejsu.

Najpierw podłącz tylko jednorazową kopię usługi, używając alternatywnych portów i bez dostępu do systemów produkcyjnych. Jeśli aplikacja zgłasza aktualizacje schematu lub uszkodzony stan, zatrzymaj ją i ponownie przywróć wolumin z niezmienionego artefaktu po rozwiązaniu problemu zgodności wersji.

Przełącz ruch i zachowaj hosta do przywrócenia

Uruchom zależności przed aplikacją, sprawdź logi, logowanie, najnowsze rekordy, załączniki, zaplanowane zadania i jednorazowy zapis testowy. Uruchom ponownie stos na hoście docelowym i potwierdź, że ponownie podłącza ten sam nazwany wolumin. Zaktualizuj ustawienia serwera proxy lub DNS dopiero po pomyślnym przejściu tych kontroli.

Powiązany artykuł ZimaSpace o spójnym tworzeniu kopii zapasowych danych kontenera może pomóc, jeśli miejsce docelowe pozostaje puste mimo pomyślnego skopiowania danych. Przed ponownym kopiowaniem porównaj źródło montowania używane w czasie działania z zamierzonym woluminem; wielokrotne kopiowanie do niewłaściwego miejsca docelowego tylko zwiększa niejasności.

Pozostaw aplikację źródłową zatrzymaną, a stary wolumin tylko do odczytu, dopóki nie uda się wykonać nowej kopii zapasowej i pomyślnie przetestować jej przywracania na hoście docelowym. Cofnij zmianę, kierując ruch z powrotem do niezmienionego źródła, tylko jeśli na hoście docelowym nie zaakceptowano żadnych nowych zapisów; w przeciwnym razie zatrzymaj się i celowo uzgodnij dane.

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.