Kan Immich een externe database gebruiken zonder upgrades te verstoren?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Je kunt Immich naar een externe PostgreSQL-service laten verwijzen, maar dat maakt upgrades niet automatisch veilig; de verantwoordelijkheid voor databaseversie, extensies, rechten, back-ups en terugdraaien komt daarmee buiten de standaardstack te liggen.

Beschouw een externe database als een geavanceerde compatibiliteitsgrens, niet als een prestatievinkje. Controleer vรณรณr elke Immich- of PostgreSQL-upgrade de vereisten van de exacte Immich-release die je wilt gebruiken, bevestig dat de externe server de vereiste extensies en rechten kan bieden, maak een herstelbare back-up en wijzig telkens maar รฉรฉn upgradeniveau, zodat je weet welk onderdeel de storing heeft veroorzaakt.

Begin met de afspraken voor de externe database

Leg het database-eindpunt, de databasenaam, het serviceaccount, de TLS-modus, de grote PostgreSQL-versie, de namen en versies van geรฏnstalleerde extensies en wie die extensies kan upgraden vast. Bewaar dit overzicht bij de definitie van de Immich-implementatie, zodat het opnieuw aanmaken van een container niet ongemerkt verbinding maakt met een andere server of database.

Een bestaande PostgreSQL-server gebruiken kan, maar is niet de standaardaanbevolen configuratie voor Immich. Voor huidige releases vereist het gebruik van een zelfstandige database pgvector plus VectorChord; Immich werkt naar verwachting met PostgreSQL 14 tot en met 19, pgvector >=0.7 en <0.9, en VectorChord >=0.3 en <2.0. Controleer deze bereiken vรณรณr elke upgrade opnieuw, want ze kunnen veranderen.

Plan de rechten vรณรณr de omschakeling. Immich verwacht doorgaans een databaserol met superuserrechten; draaien zonder die rechten is een geavanceerde optie die tijdens updates handmatige tussenkomst kan vereisen, en voor de huidige automatische databaseback-ups zijn superuserrechten vereist. Als je externe provider niet aan die vereisten kan voldoen, stop dan voordat je de productiedata verplaatst.

Controleer de compatibiliteit van PostgreSQL en extensies voordat je iets wijzigt

Noteer de huidige en beoogde PostgreSQL-versies, samen met alle extensies waarvan Immich afhankelijk is. Voor een grote PostgreSQL-upgrade kunnen extensiebinaries nodig zijn die voor de beoogde hoofdversie zijn gebouwd, terwijl een Immich-upgrade een nieuwere extensie of ander migratiegedrag kan vereisen, zelfs als PostgreSQL zelf nog steeds start.

Extensiepakketbestanden en de SQL-extensiestatus moeten bewust met de database worden bijgewerkt, in plaats van ervan uit te gaan dat ze een PostgreSQL-upgrade automatisch volgen. Bekijk afhankelijkheden voor het upgraden van PostgreSQL-extensies voordat je de grote versie van de database of de extensiepakketten wijzigt die Immich vereist.

Als je externe provider je niet toestaat de vereiste extensie te installeren of te upgraden, indien nodig gedeelde preload-instellingen te wijzigen of de benodigde rechten voor de migratie toe te kennen, stop dan voordat je Immich bijwerkt. Een database die gewone query's accepteert, is nog niet per se geschikt voor de volgende applicatiemigratie.

Houd grote database-upgrades gescheiden van Immich-upgrades

Combineer geen upgrade naar een grote PostgreSQL-versie, extensie-upgrade en Immich-applicatie-upgrade in รฉรฉn onderhoudsbeurt, tenzij je de volledige procedure al hebt geoefend. Als meerdere compatibiliteitsgrenzen tegelijk verschuiven, vertelt een mislukte start niet meer welke laag de oorzaak is.

Kleine PostgreSQL-updates en upgrades naar een grote versie zijn verschillende onderhoudswerkzaamheden. Voor upgrades naar een grote versie moet de doelomgeving, inclusief extensies van derden, eerst worden voorbereid. Houd upgrades naar een grote PostgreSQL-versie waar mogelijk gescheiden van een Immich-applicatie-upgrade, zodat je bij een mislukte start รฉรฉn duidelijke wijziging hebt om te onderzoeken.

Voor een thuisserver is de reeks met het laagste risico doorgaans: maak back-ups, controleer een herstel, werk รฉรฉn laag bij, voer validatie uit en ga dan verder. Als een Immich-release een databasewijziging vereist, volg dan de voorgeschreven volgorde voor die release in plaats van een algemene PostgreSQL-upgradeprocedure toe te passen.

Behoud een rollbackmogelijkheid voor zowel de database als de media

Bij een externe database is het makkelijker te vergeten dat de Immich-status verspreid is over PostgreSQL en de mediabibliotheek. Maak een back-up van de database met een databaseconsistente methode en bewaar de relevante media- en configuratiestatus uit hetzelfde herstelvenster vรณรณr een migratie die schema's of metagegevens van bestanden kan wijzigen.

De databasestatus, applicatiebestanden, configuratie en uploads moeten op het moment van herstel met elkaar overeenkomen. Gebruik een consistente back-up van de databasecontainer als acceptatiemodel, niet alleen de vraag of PostgreSQL start.

Noem rollback pas gereed als je weet wat er met beide onderdelen gebeurt wanneer de applicatiemigratie gedeeltelijk slaagt. Houd de oude applicatieversie, implementatiedefinitie, databaseback-up en mediastatus lang genoeg beschikbaar om te herstellen zonder nieuwere status over de enige bekende goede kopie heen te schrijven.

Valideer de upgrade als applicatie, niet alleen als databaseverbinding

Controleer na de wijziging of PostgreSQL de bedoelde Immich-rol accepteert, de vereiste extensies in de verwachte versies aanwezig zijn en de Immich-migratie wordt voltooid zonder herhaalde databasefouten. Een geslaagde TCP-verbinding of `SELECT 1` bewijst dat er verbinding is, niet dat de applicatie compatibel is.

Gebruik Immich vervolgens zoals gewoonlijk: laad oude albums, open representatieve foto's en video's, zoek, bekijk gebruikers of delen waar relevant, en upload รฉรฉn wegwerpbestand. Houd tijdens deze handelingen de logs van de applicatie en database in de gaten voor ontbrekende extensies, rechtenfouten, mislukte migraties of herhaalde pogingen.

Pas nadat de applicatie deze controles heeft doorstaan, hervat je de normale back-upbewaartermijn en verwijder je de rollbackkopie. Als de externe database ervoor zorgt dat reguliere Immich-upgrades steeds afhankelijk zijn van handmatig extensie- of rechtenbeheer dat je niet betrouwbaar kunt oefenen, is de standaard levenscyclus van de eigen database operationeel gezien de veiligere keuze.

Ondersteuning en tips

Meer om te lezen

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.