Bezpieczna lista kontrolna migracji Immich na nowy serwer domowy

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.

Bezpieczna migracja Immich zaczyna się od ustalenia, co musi zostać zachowane, zanim cokolwiek skopiujesz: pliki zdjęć, bazę danych oraz ustawienia wdrożenia, które pozwolą ponownie połączyć je na nowym hoście.

W przypadku serwera domowego ryzyko migracji zwykle wynika z przenoszenia tych elementów w różnym czasie lub uruchomienia środowiska docelowego z nieprawidłowymi ścieżkami. Potraktuj stary serwer jako kopię awaryjną do przywrócenia, wstrzymaj możliwe do uniknięcia zapisy, zanotuj bieżącą wersję i mapowanie pamięci masowej, a następnie przenieś na nową maszynę jeden zweryfikowany zestaw danych. Poniższa lista kontrolna pozwala zachować możliwość cofnięcia zmian do czasu, gdy nowa instancja będzie umożliwiać logowanie, odnajdzie oryginalną bibliotekę, przetworzy zadania i przetrwa ponowne uruchomienie bez powrotu do pustego stanu.

Zamroź źródło i zapisz znany, poprawny stan

Zacznij od działającego serwera, a nie od nowego. Zapisz wersję Immich, definicję Compose lub sklepu z aplikacjami, wartości zmiennych środowiskowych sterujących ścieżkami bazy danych i pamięci masowej, lokalizację biblioteki zdjęć, lokalizację bazy danych oraz wszelkie punkty montowania bibliotek zewnętrznych. Zanotuj też bieżący adres URL serwera i konto użytkownika, którego użyjesz do weryfikacji.

Celem tej inwentaryzacji jest zapobieżenie sytuacji, w której migracja niepostrzeżenie staje się jednocześnie aktualizacją, zmianą układu ścieżek i zmianą sieci. Do czasu pomyślnego odtworzenia utrzymuj wersję aplikacji i logiczny układ pamięci masowej w miarę możliwości bez zmian; zmiany wersji można wprowadzić później, gdy potwierdzisz, że środowisko docelowe działa.

Przed kopiowaniem zatrzymaj lub wstrzymaj nowe przesyłanie, jeśli domownicy mogą sobie na to pozwolić. Jeśli to niepraktyczne, wyznacz okno przełączenia i zaplanuj krótką synchronizację końcową. Po zakończeniu tego etapu powinna powstać pisemna mapa źródłowa, która pozwoli ustalić, gdzie znajdują się oryginały, gdzie zapisany jest stan bazy danych i która konfiguracja odtwarza te same powiązania.

Przenieś bazę danych, pliki i konfigurację jako jeden zestaw

Traktuj bazę danych i pliki multimedialne jako jeden zestaw do odtworzenia, a nie dwie niezależne kopie zapasowe. Obecne kopie zapasowe bazy danych Immich zawierają metadane i odwołania do plików, ale nie same zdjęcia ani filmy, dlatego kopii bazy danych muszą towarzyszyć odpowiadające im pliki z UPLOAD_LOCATION oraz wszelkie dane z bibliotek zewnętrznych, którymi zarządzasz osobno.

Przydatny zestaw migracyjny wymaga plików, stanu PostgreSQL i konfiguracji, która pozwala je ponownie połączyć. Kompletny zestaw kopii zapasowej Immich obejmuje przesłane pliki, obsługiwaną kopię zapasową bazy danych i konfigurację wdrożenia; przywrócenie testowe służy do potwierdzenia, że zestaw działa. Przechowuj te elementy razem, aby można było powiązać miejsce docelowe z jednym punktem odzyskiwania.

Zweryfikuj zestaw migracyjny, zanim cokolwiek zmienisz na serwerze docelowym. Sprawdź, czy zrzut bazy danych nie jest pusty, przejrzyj kilka oryginalnych plików ze skopiowanej biblioteki oraz zapisz pliki Compose i środowiskowy w tym samym folderze migracji lub zestawie dokumentacji. Jeśli nie da się zweryfikować któregoś z tych elementów, zatrzymaj się i utwórz nową kopię zamiast próbować naprawiać sytuację na nowym serwerze.

Przygotuj nowy host, nie tworząc konkurencyjnego stanu

Najpierw utwórz katalogi docelowe i punkty montowania, a następnie sprawdź, czy nowy host widzi właściwe dyski lub udziały sieciowe pod dokładnie tymi ścieżkami, których zamierzasz użyć. Brakujący punkt montowania NAS może pozostawić zwykły, pusty katalog, a kontener może bez problemu zainicjować się w tej zastępczej lokalizacji.

Zainstaluj środowisko uruchomieniowe i odtwórz konfigurację wdrożenia, ale nie pozwól, by pusta instancja Immich zaczęła gromadzić przesłane pliki lub konfigurację, zanim przywrócisz poprzedni stan. Zachowaj zgodność danych logowania, nazwy bazy danych, zmiennych pamięci masowej i punktów montowania bibliotek zewnętrznych ze źródłem, chyba że plan migracji wyraźnie przewiduje kontrolowaną zmianę ścieżek.

Jeśli nowy serwer wymaga innych ścieżek po stronie hosta, zaplanuj ich mapowanie, zachowując spójność ścieżek widocznych w kontenerze i założeń bazy danych. Miejsce docelowe jest gotowe dopiero wtedy, gdy efektywne punkty montowania wskazują skopiowane lokalizacje danych i potrafisz wyjaśnić każde mapowanie ścieżek przed uruchomieniem całej aplikacji.

Przywróć stan i ponownie podłącz wszystkie ścieżki do pamięci masowej

Przywróć bazę danych, korzystając ze ścieżki odzyskiwania odpowiedniej dla wersji Immich, która utworzyła kopię zapasową, a pozostałe usługi uruchom dopiero po przygotowaniu bazy danych. Nie improwizuj, używając destrukcyjnych poleceń dotyczących bazy danych ze starszego poradnika, gdy nowsza instalacja wymaga innej procedury przywracania.

Podczas przełączania zachowaj powiązanie bazy danych z zasobami pamięci masowej, zanim wznowisz normalne użytkowanie. Sprawdzona procedura migracji Immich opiera się na tej samej zasadzie: aplikacja powinna uruchomić się ze stanem przywróconym z bazy danych i właściwymi ścieżkami do plików multimedialnych, zamiast inicjować pustą bibliotekę i wymuszać odbudowę od zera.

Po uruchomieniu sprawdź dostęp do pamięci masowej przed rozpoczęciem intensywnych zadań w tle. Otwórz kilka starych plików z różnych dat, sprawdź, czy miniatury się wczytują, potwierdź obecność albumu oraz osoby lub wyniku wyszukiwania istniejących przed migracją, a jeśli korzystasz z bibliotek zewnętrznych, upewnij się, że są dostępne do odczytu. Ekran konfiguracji początkowej lub pusta oś czasu to sygnał, by się zatrzymać: przed zapisaniem nowego stanu ponownie sprawdź bazę danych i mapowania punktów montowania.

Sprawdź działanie pierwotnego obciążenia przed rezygnacją ze starego serwera

Udane pierwsze logowanie nie oznacza końca migracji. Prześlij jedno tymczasowe zdjęcie testowe ze standardowego klienta, potwierdź, że pojawiło się w oczekiwanym miejscu na hoście, a następnie usuń je w Immich i sprawdź, czy biblioteka nadal działa prawidłowo. W ten sposób sprawdzisz całą ścieżkę zapisu, zamiast jedynie potwierdzić, że stare dane są dostępne do odczytu.

Uruchom ponownie nowy serwer domowy i powtórz testy istotne dla domowników: logowanie w przeglądarce, połączenie do tworzenia kopii zapasowych z urządzeń mobilnych, kilka starszych zdjęć, wyszukiwanie, reprezentatywne wideo, kolejki zadań i dostęp zdalny, jeśli należy do standardowej konfiguracji. Migrację można uznać za zakończoną dopiero wtedy, gdy ten sam stan utrzymuje się po ponownym uruchomieniu hosta, a zasoby pamięci masowej są montowane przed uruchomieniem Immich.

Pozostaw stary serwer wyłączony, ale bez zmian, na czas umożliwiający ewentualne przywrócenie, zamiast od razu go czyścić. Jeśli nowa instancja zacznie zapisywać dane w nieoczekiwanym, pustym folderze, nie odtworzy starej biblioteki po ponownym uruchomieniu albo wyświetli niewyjaśnione błędy bazy danych, wstrzymaj nowe przesyłanie i wróć do sprawdzonego źródła, porównując zestaw przeniesionych danych. Zrezygnuj ze starego hosta dopiero wtedy, gdy miejsce docelowe sprawdzi się w codziennym użytkowaniu, a test świeżej kopii zapasowej zakończy się powodzeniem.

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.