Come ripristinare Immich in sicurezza dopo una versione incompatibile

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.

Esegui il rollback di Immich solo dopo aver conservato lo stato attuale e aver determinato se la release più recente ha modificato il database o la configurazione in modo incompatibile con l’immagine meno recente.

Un’immagine del container può essere sostituita, ma i suoi dati persistenti potrebbero essere già stati migrati. Se un aggiornamento inizia a dare problemi, interrompi gli aggiornamenti automatici e le nuove scritture, annota entrambe le versioni, proteggi il database e i file multimediali attuali, quindi scegli tra un semplice rollback dell’immagine e il ripristino del punto di recupero precedente all’aggiornamento.

Blocca l’aggiornamento non riuscito prima che modifichi altri dati

Disattiva gli aggiornamenti automatici delle immagini e impedisci ai client di aggiungere nuove foto mentre raccogli le prove. Annota le versioni o i digest esatti delle immagini Immich vecchia e nuova, la versione di PostgreSQL, i file Compose e di ambiente, i percorsi di montaggio e il primo errore di avvio o migrazione.

La guida di ZimaSpace sui limiti del rollback dei container evidenzia la distinzione fondamentale: i volumi persistenti sopravvivono alla sostituzione dell’immagine, ma è sicuro solo se l’applicazione meno recente resta compatibile con i dati al loro interno.

Crea un backup del database nel suo formato nativo dello stato attuale in errore, se è possibile leggere il database, e conserva separatamente il backup precedente all’aggiornamento. Non sovrascrivere nessuno dei due con esperimenti ripetuti. La copia attuale potrebbe servire per procedere in seguito, anche se l’obiettivo immediato è tornare alla versione precedente.

Determina se la release ha superato un passaggio di migrazione del database

Esamina il primo errore successivo all’aggiornamento e individua se si verifica prima o durante la migrazione del database, dopo la migrazione durante l’avvio dell’applicazione oppure solo nel corso di un’operazione dell’utente. Questa tempistica cambia il piano di rollback, perché un’immagine meno recente potrebbe non riconoscere uno schema già modificato dalla release più recente.

Una recente segnalazione su Immich, in cui il servizio ha smesso di funzionare dopo una procedura di aggiornamento, mostra perché i percorsi di migrazione non supportati o saltati possono rendere inaffidabile il semplice cambio di versione. Considera la discussione un caso di studio e verifica la sequenza di migrazione esatta per le tue versioni.

Se l’applicazione più recente non ha mai modificato il database e il problema riguarda solo la compatibilità dell’immagine o del runtime, può bastare ripristinare un’immagine fissata a una versione specifica. Se le migrazioni sono state completate, considera il backup del database precedente all’aggiornamento l’abbinamento più sicuro per la vecchia immagine, a meno che tu non disponga di prove esplicite di compatibilità.

Ripristina database e runtime corrispondenti, invece di mescolare versioni incompatibili

Crea il target di rollback a partire dall’ultima versione funzionante dell’applicazione, dalla relativa configurazione di deployment compatibile e dal punto di ripristino del database precedente alla modifica incompatibile. Mantieni intatto l’albero dei file multimediali, a meno che la release non abbia modificato i file multimediali in modo documentato; non ricopiare terabyte di dati solo perché è cambiata l’immagine dell’applicazione.

La discussione sul rollback del database nella pianificazione dei rollback compatibili con il database spiega il pericolo generale di distribuire codice precedente su uno schema che non è più in grado di interpretare. Questo principio è più importante del fatto che il container si avvii correttamente o meno.

Avvia l'istanza di rollback in isolamento, in modo che i client mobili e i processi pianificati non possano scrivere finché la convalida non è terminata. Se la versione precedente segnala subito errori dello schema, fermati. Non forzare manualmente le migrazioni all'indietro sull'unica copia del database, a meno che tu non disponga di una procedura di ripristino specifica per la versione e già collaudata.

Fissa l'immagine esatta nota come funzionante e riproducine la configurazione

Usa una versione specifica o un riferimento immutabile all'immagine invece di un tag mobile. Ripristina l'ambiente, le dipendenze del servizio, le mappature dei dispositivi, le reti, le porte e la destinazione del reverse proxy della distribuzione nota come funzionante. Un rollback che modifica silenziosamente diversi livelli dell'infrastruttura crea un secondo incidente.

Conserva l'immagine e la configurazione più recenti non riuscite insieme alle note sul rollback. In questo modo sarà possibile ripristinare lo stato in avanti in modo controllato, una volta compresa l'incompatibilità. Rimuovere subito ogni nuovo artefatto può rendere più difficile confrontare gli stati non riuscito e funzionante o riprodurre l'aggiornamento in un ambiente di test.

Se il servizio precedente si avvia con lo stato ripristinato, controlla i log prima di abilitare i client. Verifica che non vengano avviate migrazioni impreviste o l'inizializzazione di una nuova installazione, che il mount dello storage sia presente e che i permessi non vengano riscritti. La sola pagina di accesso non prova che il rollback stia usando i dati previsti.

Convalida la versione precedente con la configurazione di avvio originale e mantieni una strada per aggiornare in avanti

Verifica utenti rappresentativi, risorse vecchie e recenti, album, condivisione, ricerca, un nuovo caricamento controllato, processi in background, creazione del backup del database e percorso del reverse proxy. Riavvia lo stack una volta e conferma che gli stessi mount e lo stesso database tornino disponibili senza interventi manuali.

Tieni in pausa i nuovi caricamenti finché questi controlli non sono superati, poi riapri l'accesso e monitora la normale finestra di carico. Conserva sia il backup precedente all'aggiornamento sia quello dello stato più recente non riuscito, così da poter riprovare l'aggiornamento in seguito in una copia isolata, una volta compresa l'incompatibilità.

Il rollback non è riuscito se la versione precedente segnala un'incompatibilità dello schema, mancano dati noti o le scritture finiscono in un percorso imprevisto. Fermati e ripristina di nuovo il punto di ripristino conservato, invece di stratificare le correzioni. Per l'escalation, includi le versioni esatte, i log delle migrazioni, i timestamp dei backup del database, il diff di Compose e il primo passaggio di verifica che non riesce.

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.