Czy Immich może korzystać z zewnętrznej bazy danych bez zakłócania aktualizacji?

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.

Immich można połączyć z zewnętrzną usługą PostgreSQL, ale nie oznacza to, że aktualizacje są automatycznie bezpieczne; odpowiedzialność za wersję bazy danych, rozszerzenia, uprawnienia, kopie zapasowe i przywracanie poprzedniego stanu spoczywa wtedy poza domyślnym stosem.

Traktuj zewnętrzną bazę danych jako zaawansowany obszar zgodności, a nie tylko opcję poprawy wydajności. Przed każdą aktualizacją Immich lub PostgreSQL sprawdź wymagania dokładnie tego wydania Immich, które planujesz uruchomić, upewnij się, że zewnętrzny serwer może udostępnić wymagane rozszerzenia i uprawnienia, przygotuj kopię zapasową, którą da się odtworzyć, i aktualizuj tylko jedną warstwę naraz, aby wiedzieć, który komponent spowodował problem.

Zacznij od ustalenia wymagań dotyczących zewnętrznej bazy danych

Zapisz adres bazy danych, jej nazwę, konto usługi, tryb TLS, główną wersję PostgreSQL, nazwy i wersje zainstalowanych rozszerzeń oraz informację, kto może je aktualizować. Przechowuj te informacje razem z definicją wdrożenia Immich, aby ponowne utworzenie kontenera nie powodowało po cichu ponownego połączenia z innym serwerem lub bazą danych.

Można użyć istniejącego serwera PostgreSQL, ale nie jest to domyślna zalecana konfiguracja Immich. W aktualnych wydaniach ścieżka z samodzielną bazą danych wymaga pgvector oraz VectorChord; wiadomo, że Immich działa z PostgreSQL w wersjach od 14 do 19, pgvector >=0.7 i <0.9 oraz VectorChord >=0.3 i <2.0. Przed każdą aktualizacją ponownie sprawdź te zakresy, bo mogą się zmieniać.

Zaplanуj uprawnienia przed przełączeniem. Immich zazwyczaj wymaga roli bazy danych z uprawnieniami superużytkownika; korzystanie z niego bez takich uprawnień to zaawansowane rozwiązanie, które może wymagać ręcznej interwencji podczas aktualizacji. Obecne automatyczne kopie zapasowe bazy danych również wymagają uprawnień superużytkownika. Jeśli zewnętrzny dostawca nie może spełnić tych wymagań, zatrzymaj się przed przeniesieniem danych produkcyjnych.

Sprawdź zgodność PostgreSQL i rozszerzeń przed wprowadzeniem jakichkolwiek zmian

Zapisz obecne i docelowe wersje PostgreSQL wraz ze wszystkimi rozszerzeniami, od których zależy Immich. Duża aktualizacja PostgreSQL może wymagać plików binarnych rozszerzeń skompilowanych dla docelowej głównej wersji, a aktualizacja Immich może wymagać nowszego rozszerzenia lub zmiany zachowania migracji, nawet jeśli sam PostgreSQL nadal się uruchamia.

Pliki pakietów rozszerzeń i stan rozszerzeń w SQL trzeba świadomie przenosić razem z bazą danych, zamiast zakładać, że zostaną przeniesione podczas aktualizacji PostgreSQL. Przed zmianą głównej wersji bazy danych lub pakietów rozszerzeń wymaganych przez Immich zapoznaj się z informacjami o zależnościach aktualizacji rozszerzeń PostgreSQL.

Jeśli zewnętrzny dostawca nie pozwala zainstalować ani zaktualizować wymaganego rozszerzenia, zmienić ustawień współdzielonego preloadu, gdy jest to konieczne, lub nadać uprawnień wymaganych przez migrację, zatrzymaj się przed aktualizacją Immich. Baza danych, która obsługuje zwykłe zapytania, nadal może nie nadawać się do następnej migracji aplikacji.

Duże aktualizacje bazy danych przeprowadzaj oddzielnie od aktualizacji Immich

Unikaj łączenia aktualizacji PostgreSQL do nowej głównej wersji, aktualizacji rozszerzeń i aktualizacji aplikacji Immich w ramach jednego przeglądu konserwacyjnego, chyba że wcześniej przećwiczono całą sekwencję. Gdy jednocześnie zmienia się kilka granic zgodności, nieudane uruchomienie nie wskazuje już, która warstwa jest przyczyną problemu.

Drobne aktualizacje PostgreSQL i aktualizacje do nowej głównej wersji to różne działania konserwacyjne. Przed aktualizacją do nowej głównej wersji trzeba przygotować środowisko docelowe, w tym rozszerzenia firm trzecich. Jeśli to możliwe, przeprowadzaj aktualizacje do nowej głównej wersji PostgreSQL oddzielnie od aktualizacji aplikacji Immich, aby w razie nieudanego uruchomienia łatwiej było ustalić przyczynę.

W przypadku domowego serwera sekwencja niosąca zwykle najmniejsze ryzyko wygląda tak: utwórz kopie zapasowe, sprawdź możliwość ich przywrócenia, zaktualizuj jedną warstwę, przeprowadź weryfikację, a dopiero potem kontynuuj. Jeśli wydanie Immich wymaga zmiany w bazie danych, postępuj zgodnie z zalecaną kolejnością dla tego wydania zamiast stosować ogólną procedurę aktualizacji PostgreSQL.

Zachowaj możliwość wycofania zmian obejmującą bazę danych i pliki multimedialne

W przypadku zewnętrznej bazy danych łatwo zapomnieć, że dane Immich są podzielone między PostgreSQL a bibliotekę plików multimedialnych. Przed migracją, która może zmienić schematy lub metadane zasobów, utwórz kopię bazy danych metodą zapewniającą jej spójność i zachowaj odpowiedni stan plików multimedialnych oraz konfiguracji z tego samego okresu odtwarzania.

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

Nie uznawaj możliwości wycofania zmian za gotową, dopóki nie wiesz, co stanie się z obiema stronami w razie częściowego powodzenia migracji aplikacji. Zachowaj poprzednią wersję aplikacji, definicję wdrożenia, kopię zapasową bazy danych i stan plików multimedialnych na tyle długo, by móc przywrócić system bez nadpisania nowszymi danymi jedynej znanej, działającej kopii.

Sprawdź aktualizację aplikacji, a nie tylko połączenie z bazą danych

Po zmianie sprawdź, czy PostgreSQL akceptuje zamierzoną rolę Immich, wymagane rozszerzenia są dostępne w oczekiwanych wersjach, a migracja Immich kończy się bez powtarzających się błędów bazy danych. Pomyślne połączenie TCP lub `SELECT 1` potwierdza łączność, a nie zgodność z aplikacją.

Następnie korzystaj z Immich jak zwykle: wczytaj stare albumy, otwórz przykładowe zdjęcia i filmy, wyszukaj coś, sprawdź użytkowników lub udostępnianie, jeśli ma to zastosowanie, i prześlij jeden zbędny plik. Podczas tych działań obserwuj logi aplikacji i bazy danych pod kątem brakujących rozszerzeń, błędów uprawnień, niepowodzeń migracji lub ponawianych prób.

Dopiero gdy aplikacja pomyślnie przejdzie te kontrole, przywróć zwykłą retencję kopii zapasowych i usuń kopię umożliwiającą wycofanie zmian. Jeśli aktualizacje Immich z zewnętrzną bazą danych wielokrotnie wymagają ręcznej obsługi rozszerzeń lub uprawnień, której nie da się wiarygodnie przećwiczyć, bezpieczniejszym rozwiązaniem operacyjnym będzie domyślny cykl życia dedykowanej bazy danych.

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.