Immich può usare un database esterno senza compromettere gli aggiornamenti?

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

È possibile configurare Immich per usare un servizio PostgreSQL esterno, ma questo non rende automaticamente sicuri gli aggiornamenti: la responsabilità per la versione del database, le estensioni, i privilegi, i backup e il ripristino ricade al di fuori dello stack predefinito.

Considera un database esterno come un confine di compatibilità avanzato, non come una semplice opzione per le prestazioni. Prima di ogni aggiornamento di Immich o PostgreSQL, verifica i requisiti della versione esatta di Immich che prevedi di eseguire, conferma che il server esterno possa fornire le estensioni e i privilegi necessari, crea un backup ripristinabile e modifica un solo livello alla volta, così da sapere quale componente ha causato un problema.

Parti dai requisiti del database esterno

Documenta l’endpoint del database, il nome del database, l’account di servizio, la modalità TLS, la versione principale di PostgreSQL, i nomi e le versioni delle estensioni installate e chi può aggiornarle. Conserva queste informazioni insieme alla definizione della distribuzione di Immich, in modo che la ricreazione di un container non si colleghi silenziosamente a un server o a un database diverso.

È possibile usare un server PostgreSQL preesistente, ma non è la configurazione predefinita consigliata per Immich. Nelle versioni attuali, la configurazione con database indipendente richiede pgvector e VectorChord; è noto che Immich funziona con PostgreSQL dalla versione 14 alla 19, pgvector >=0.7 e <0.9 e VectorChord >=0.3 e <2.0. Ricontrolla questi intervalli prima di ogni aggiornamento, perché potrebbero cambiare.

Pianifica i privilegi prima del passaggio. In genere Immich richiede un ruolo del database con privilegi di superutente; eseguirlo senza tali privilegi è una procedura avanzata che può richiedere interventi manuali durante gli aggiornamenti, e gli attuali backup automatici del database richiedono privilegi di superutente. Se il tuo provider esterno non può soddisfare questi requisiti, fermati prima di trasferire i dati di produzione.

Verifica la compatibilità di PostgreSQL e delle estensioni prima di apportare modifiche

Elenca le versioni attuali e di destinazione di PostgreSQL insieme a tutte le estensioni da cui dipende Immich. Un aggiornamento principale di PostgreSQL può richiedere file binari delle estensioni compilati per la versione principale di destinazione, mentre un aggiornamento di Immich può richiedere un’estensione più recente o modifiche al comportamento della migrazione, anche se PostgreSQL si avvia ancora.

I file dei pacchetti delle estensioni e lo stato SQL delle estensioni devono essere trasferiti intenzionalmente insieme al database, senza presumere che seguano un aggiornamento di PostgreSQL. Consulta Dipendenze per l’aggiornamento delle estensioni di PostgreSQL prima di modificare la versione principale del database o i pacchetti delle estensioni richieste da Immich.

Se il tuo provider esterno non ti consente di installare o aggiornare l’estensione richiesta, di modificare le impostazioni di precaricamento condivise quando necessario o di concedere i privilegi richiesti dalla migrazione, fermati prima di aggiornare Immich. Un database che accetta le query ordinarie può comunque non essere adatto alla migrazione successiva dell’applicazione.

Tieni separati gli aggiornamenti principali del database da quelli di Immich

Evita di combinare un aggiornamento alla versione principale di PostgreSQL, un aggiornamento delle estensioni e un aggiornamento dell'applicazione Immich nello stesso intervento di manutenzione, a meno che tu non abbia già provato l'intera sequenza. Se cambiano contemporaneamente più confini di compatibilità, un mancato avvio non indica più quale livello ne sia la causa.

Gli aggiornamenti minori di PostgreSQL e quelli alle versioni principali sono interventi di manutenzione diversi; per gli aggiornamenti alle versioni principali occorre preparare prima l'ambiente di destinazione, comprese le estensioni di terze parti. Quando possibile, tieni separati gli aggiornamenti alle versioni principali di PostgreSQL da un aggiornamento dell'applicazione Immich, così, in caso di mancato avvio, sarà chiaro quale modifica esaminare.

Per un server domestico, la sequenza a minor rischio è in genere: creare i backup, verificarne il ripristino, aggiornare un livello, eseguire la convalida e poi proseguire. Se una versione di Immich richiede una modifica al database, segui l'ordine prescritto per quella versione invece di applicare una procedura generica di aggiornamento di PostgreSQL.

Mantieni un percorso di rollback che includa sia il database sia i file multimediali

Con un database esterno è facile dimenticare che lo stato di Immich è suddiviso tra PostgreSQL e la libreria multimediale. Esegui il backup del database con un metodo che ne garantisca la coerenza e conserva lo stato pertinente di file multimediali e configurazione relativo alla stessa finestra di ripristino, prima di una migrazione che possa modificare schemi o metadati delle risorse.

Lo stato del database, i file dell'applicazione, la configurazione e i caricamenti devono essere coerenti al momento del ripristino. Usa un backup coerente del container del database come criterio di accettazione, non limitarti a verificare che PostgreSQL si avvii.

Non considerare pronto il rollback finché non sai cosa succede a entrambi i componenti se la migrazione dell'applicazione riesce solo in parte. Conserva la vecchia versione dell'applicazione, la definizione della distribuzione, il backup del database e lo stato dei file multimediali abbastanza a lungo da poter ripristinare il sistema senza sovrascrivere lo stato più recente sull'unica copia sicuramente integra.

Convalida l'aggiornamento come applicazione, non solo come connessione al database

Dopo la modifica, verifica che PostgreSQL accetti il ruolo Immich previsto, che le estensioni richieste siano presenti nelle versioni attese e che la migrazione di Immich si completi senza errori ripetuti del database. Una connessione TCP riuscita o `SELECT 1` dimostra la connettività, non la compatibilità dell'applicazione.

Poi usa Immich normalmente: carica vecchi album, apri alcune foto e alcuni video rappresentativi, esegui ricerche, controlla gli utenti o la condivisione, se pertinente, e carica un contenuto di prova sacrificabile. Durante queste operazioni, controlla i log dell'applicazione e del database per rilevare estensioni mancanti, errori di autorizzazione, errori di migrazione o tentativi ripetuti.

Solo dopo che l'applicazione ha superato queste verifiche, riprendi la normale conservazione dei backup e rimuovi la copia di rollback. Se le routine di aggiornamento di Immich con il database esterno richiedono ripetutamente interventi manuali su estensioni o privilegi che non puoi testare in modo affidabile, il ciclo di vita predefinito del database dedicato è la scelta operativa più sicura.

Assistenza e consigli

Altre letture

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.