Jak odzyskać bazę danych Immich z pewnej kopii zapasowej

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.

Sprawdzona kopia zapasowa bazy danych Immich jest przydatna tylko wtedy, gdy odtworzysz ją w kontrolowanym środowisku i potwierdzisz, że odzyskana baza danych nadal wskazuje pliki multimedialne widoczne dla Twojego serwera.

Traktuj odzyskiwanie jako sekwencję działań, a nie pojedyncze polecenie importu. Najpierw zachowaj instancję po awarii, ustal wersję Immich i znacznik czasu kopii zapasowej, uruchom czyste i zgodne środowisko docelowe bazy danych, odtwórz dane, nie pozwalając aplikacji najpierw zapisywać do pustego schematu, a następnie sprawdź konta, dane osi czasu, ścieżki do plików multimedialnych i możliwość wykonania nowego zapisu. Jeśli którykolwiek krok budzi wątpliwości, zatrzymaj się, zanim zastąpisz ostatnią możliwą do odzyskania kopię.

Zamroź stan po awarii, zanim cokolwiek odtworzysz

Przed rozpoczęciem odzyskiwania zatrzymaj nowe przesyłanie plików i zapisy w tle w dotkniętej awarią instancji Immich. Zapisz bieżący plik Compose, wartości zmiennych środowiskowych, zamontowane ścieżki, wersje obrazów, najnowsze logi oraz uszkodzony stan bazy danych, jeśli pozwala na to dostępna przestrzeń dyskowa. Nawet uszkodzona baza danych może zawierać informacje wyjaśniające, co się stało, a jej nadpisanie usuwa te informacje.

Dokładnie określ, której kopii zapasowej zamierzasz zaufać. Zapisz jej znacznik czasu, sposób utworzenia, rozmiar pliku oraz informację, czy kiedykolwiek przeprowadzono jej testowe odtworzenie. Zrzut SQL utworzony przez bazę danych to inny zasób do odzyskiwania niż surowa kopia bieżącego katalogu danych PostgreSQL; nie traktuj ich zamiennie.

Jeśli to możliwe, utwórz środowisko docelowe do odzyskiwania w osobnym katalogu lub odizolowanym stosie. Warunek zakończenia tego etapu jest prosty: pierwotny stan awarii jest zachowany, wybrana kopia zapasowa jest tylko do odczytu, a Ty wiesz, z którą wersją wdrożenia i ścieżkami przechowywania ma zostać ponownie połączone odtworzone środowisko.

Sprawdź, czy kopię zapasową można rzeczywiście odtworzyć

Przed odtworzeniem sprawdź kopię zapasową. Skompresowany zrzut SQL powinien poprawnie się rozpakować i zawierać rozpoznawalną zawartość zrzutu PostgreSQL, a nie pusty archiwum utworzone przez nieudany potok. Jeśli masz sumy kontrolne lub wyniki weryfikacji repozytorium, porównaj je teraz, zamiast odkrywać uszkodzenie w połowie odzyskiwania.

Zrzut PostgreSQL jest bezpieczniejszym zasobem do odzyskiwania niż zwykłe skopiowanie katalogu działającej bazy danych, ponieważ powstaje przy użyciu narzędzi uwzględniających specyfikę bazy i można go odtworzyć w czystym środowisku docelowym. Wzorzec tworzenia kopii zapasowej w postaci zrzutu bazy danych oddziela również bazę danych od kopii plików multimedialnych, co ułatwia sprawdzenie każdej z tych części przed odzyskiwaniem.

Sprawdź również, czy pliki multimedialne i konfiguracja z okresu tworzenia kopii zapasowej nadal istnieją. Samo przywrócenie bazy danych może odzyskać użytkowników, albumy, metadane i odwołania do plików, ale wszystkie zasoby będą niedostępne, jeśli brakuje wskazanych ścieżek do biblioteki. Kontynuuj tylko wtedy, gdy zrzut oraz zestaw plików multimedialnych i konfiguracji pochodzą z tego samego, znanego punktu odzyskiwania.

Najpierw uruchom czystą, zgodną bazę danych

Dopasuj metodę przywracania do wersji, w której utworzono kopię zapasową. Aktualne wydania Immich umożliwiają przywracanie bazy danych z poziomu Administracja > Konserwacja oraz w kreatorze pierwszej konfiguracji; w przypadku starszych kopii zapasowych mogą być potrzebne instrukcje ręczne dotyczące konkretnej wersji. Proces przywracania zmienił się w wersji v2.5.0.

W przypadku nowego środowiska docelowego nie pozwól, aby Immich uruchomił standardowe migracje na pustym schemacie, zanim baza danych będzie gotowa do odtworzenia. Jeśli wdrożenie uruchamia aplikację razem z PostgreSQL, skorzystaj z ustawień przywracania odpowiednich dla danej wersji, aby serwer nie utworzył konkurencyjnego stanu przed importem.

Jeśli baza danych sama nie wróci do prawidłowego stanu, zatrzymaj się i najpierw rozwiąż ten problem. Nie odtwarzaj w kółko tej samej kopii zapasowej do środowiska docelowego, które się restartuje, nie ma miejsca na dysku lub korzysta z niezgodnego układu pamięci masowej. Czyste i stabilne środowisko docelowe to warunek wstępny, a nie poboczny problem do rozwiązania.

Przywróć zrzut raz i zatrzymaj się przy pierwszym błędzie

Przywróć wybrany zrzut do przygotowanej bazy danych i zapisz pełny wynik działania. Użyj narzędzi i opcji bazy danych odpowiednich dla formatu zrzutu, aby błąd był wyraźnie widoczny i powodował niepowodzenie przywracania, zamiast pozostawiać częściowo zaimportowany schemat, który mimo to się uruchamia.

Zestaw do migracji, którego można użyć, musi zawierać zasoby, stan PostgreSQL i konfigurację umożliwiającą ich ponowne połączenie. Kompletny zestaw kopii zapasowych Immich obejmuje przesłane zasoby, obsługiwaną kopię zapasową bazy danych i konfigurację wdrożenia; poprawność zestawu potwierdzają testy przywracania. Przechowuj te elementy razem, aby można było dopasować środowisko docelowe do jednego punktu odzyskiwania.

Po pomyślnym zaimportowaniu uruchom aplikację Immich i uważnie obserwuj jej pierwsze uruchomienie. Jeśli interfejs poprosi o utworzenie nowego pierwszego administratora zamiast zaakceptować istniejące konta, zatrzymaj się: to mocno wskazuje, że Immich korzysta z innej bazy danych niż przywrócona. Nie zaczynaj ponownie przesyłać zdjęć do tego pustego stanu.

Sprawdź stan bazy danych, ścieżki do multimediów i nowy zapis

Zaloguj się na istniejące konto i sprawdź oś czasu, przeglądając starsze i nowsze daty. Otwórz kilka oryginalnych plików, sprawdź albumy lub ulubione, które powinny być dostępne, i upewnij się, że aplikacja może odnaleźć powiązane pliki, a nie tylko wyświetlać wiersze z bazy danych.

Stan bazy danych, pliki aplikacji, konfiguracja i przesłane pliki muszą być ze sobą zgodne w chwili przywracania. Jako kryterium akceptacji przyjmij spójną kopię zapasową kontenera bazy danych, a nie samo uruchomienie PostgreSQL.

Na koniec prześlij jedno tymczasowe zdjęcie, poczekaj na jego standardowe przetworzenie, sprawdź, czy przetrwa ponowne uruchomienie Immich i restart hosta, a następnie usuń je z poziomu aplikacji. Jeśli konta, stare zasoby i nowy zapis działają prawidłowo, utwórz świeżą kopię zapasową odzyskanego stanu przed aktualizacją wersji. Jeśli nie, wróć do zachowanych dowodów awarii albo starszej, sprawdzonej kopii zapasowej, zamiast pogłębiać problem.

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.