Czym jest stan Immich i które jego elementy muszą być zachowane?

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

What Is Immich State, and Which Parts Must Persist?

Stan Immich to połączone dane multimedialne, baza danych, dane tożsamości, konfiguracja oraz dane pochodne wymagane do odtworzenia zamierzonego działania biblioteki.

Oryginalne pliki są niezbędne, ale nie stanowią całej aplikacji. Albumy, użytkownicy, własność, twarze, reprezentacje wyszukiwania, mapowania ścieżek i sekrety decydują o tym, jak te pliki się wyświetlają i kto może z nich korzystać; niektóre z tych danych są źródłem prawdy, a inne można odbudować kosztem czasu i zasobów.

Oryginalne multimedia i relacje w bazie danych tworzą rdzeń

Oryginalne zdjęcia i filmy zachowują niezastąpioną treść. Baza danych przechowuje sposób, w jaki Immich interpretuje te dane: użytkowników, własność, albumy, identyfikatory zasobów, metadane i relacje przetwarzania. Każda z tych stron osobno jest niekompletna, jeśli celem jest przywrócenie tej samej domowej usługi, a nie tylko odzyskanie luźnych plików.

Przewodnik tworzenia kopii zapasowej Immich firmy ZimaSpace wyjaśnia, że kompleksowa ochrona obejmuje przesłane multimedia i bazę danych. To rozróżnienie zapewnia użyteczną definicję stanu: multimedia odpowiadają na pytanie, jakie bajty istnieją, a rekordy bazy danych wskazują, jak aplikacja kojarzy, prezentuje i kontroluje te bajty.

Przypisz bazę danych i każdą lokalizację oryginalnych multimediów do trwałych ścieżek hosta lub systemu pamięci masowej. Potwierdź, że biblioteki zewnętrzne są chronione własną polityką. Nie wyciągaj wniosków o trwałości na podstawie wewnętrznej ścieżki kontenera; sprawdź faktycznie używany wolumin lub montowanie bind, które przetrwa usunięcie i ponowne utworzenie kontenera.

Konfiguracja i sekrety odtwarzają granice usługi

Definicje Compose, ustawienia środowiskowe, mapowania pamięci masowej, reguły serwera proxy i konfiguracja dostawcy tożsamości określają, w jaki sposób usługi odnajdują dane i siebie nawzajem. Hasła, materiały podpisujące i dane uwierzytelniające API również muszą zostać bezpiecznie zachowane. Odtworzenie plików bez tych ustawień może sprawić, że baza danych będzie dostępna przy użyciu niewłaściwej tożsamości lub ścieżek.

Analiza planowania pamięci masowej dla Immich rozdziela lokalizację bazy danych i miniatur od masowej pamięci na oryginalne pliki. Jej wniosek ma charakter architektoniczny: jedna logiczna usługa może obejmować kilka fizycznych lokalizacji, dlatego inwentaryzacja trwałych danych musi uwzględniać każde montowanie i każdą zależność, a nie tylko jeden katalog projektu.

Przechowuj definicje wdrożenia w systemie kontroli wersji po usunięciu sekretów. Sekrety trzymaj w zaszyfrowanej kopii zapasowej lub menedżerze sekretów, z udokumentowaną ścieżką przywracania. Zapisz właścicieli i uprawnienia dla montowań bind. Podczas testu sprawdź dostęp usługi do bazy danych i odczyt multimediów, zanim udostępnisz zdalny dostęp lub zaakceptujesz nowe przesyłane pliki.

Dane pochodne można odbudować, ale mają znaczenie operacyjne

Miniatury, zakodowane filmy i niektóre wyniki uczenia maszynowego można wygenerować ponownie na podstawie danych źródłowych, zależnie od wersji i zachowanych rekordów. Pominięcie ich może zmniejszyć rozmiar kopii zapasowych. Ceną są jednak czas, moc obliczeniowa, ciepło i mniejsza responsywność podczas odbudowy dużej rodzinnej biblioteki na przywróconym serwerze.

Niezależny przewodnik tworzenia kopii zapasowych odróżnia niezbędne dane przesłanych plików, biblioteki i profilu od miniatur oraz zakodowanych filmów, które Immich może wygenerować ponownie. Nie oznacza to, że dane pochodne są nieistotne; daje operatorom wybór między rozmiarem kopii zapasowej a czasem potrzebnym do odzyskania w pełni przygotowanego przeglądania i odtwarzania.

Przed wykluczeniem danych pochodnych zmierz tempo odbudowy na reprezentatywnej próbie. Ostrożnie pomnóż wynik przez strukturę dotkniętych zasobów i uwzględnij zapisy na pamięć masową oraz konkurencję o zasoby na pierwszym planie. Jeśli wynikające z tego opóźnienie przekracza cel odtworzenia, chroń wybrane ścieżki danych pochodnych lub zapewnij dodatkową moc obliczeniową na czas odbudowy.

-15% OFF

ZimaBoard 2 – Mini serwer domowy dla Twojego wielkiego pomysłu

Single board computer zimaboard2

Potwierdź trwałość za pomocą testu zniszczenia kontenerów

Użyj tymczasowej kopii wdrożenia, nigdy środowiska produkcyjnego. Zapisz sumy kontrolne przykładowych oryginałów, testowego albumu, dwóch kont o różnym poziomie dostępu i jednego znanego wyszukiwania. Usuń tylko sklonowane kontenery, zachowując zadeklarowaną trwałą pamięć masową, a następnie odtwórz stos na podstawie zapisanej konfiguracji i sekretów.

Raport społeczności dotyczący trwałości danych opisuje sytuację, w której Immich po ponownym uruchomieniu wracał do procesu konfiguracji, ponieważ zamierzony katalog bazy danych na hoście pozostawał pusty. To ostrzegawczy przykład pokazujący, dlaczego skonfigurowana ścieżka nie jest dowodem, że zapisy rzeczywiście do niej trafiają; obserwowalny stan musi przetrwać faktyczną operację cyklu życia, której dotyczy deklarowana trwałość.

Test uznaj za zaliczony dopiero wtedy, gdy oba konta zostaną przywrócone, członkostwo w albumach będzie zgodne, sumy kontrolne oryginałów będą się zgadzać, a znane wyszukiwanie będzie działać zgodnie z oczekiwaniami lub przejdzie w udokumentowany stan odbudowy. Każde niewyjaśnione zresetowanie wskazuje na brak trwałości danych. Zaktualizuj mapę stanu, zanim zaufasz automatyzacji kopii zapasowych opartej na tych samych założeniach.