Come ripristinare Immich dopo un aggiornamento non riuscito del container

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.

Ripristina Immich dopo un aggiornamento dei container non riuscito bloccando le prove attuali, fissando ogni servizio Immich all’ultima versione funzionante e ripristinando i dati solo se non è possibile avviare lo stack con un rollback coordinato.

Un aggiornamento può modificare contemporaneamente il codice dell’applicazione, le aspettative sullo schema del database, le variabili d’ambiente e le versioni dei servizi complementari. Eseguire ripetutamente il pull dell’ultima versione o combinare container vecchi e nuovi rende più difficile individuare il limite del ripristino. Prima di intervenire, salva il file Compose, l’ambiente, i log, il database e i percorsi dei file caricati; poi scegli tra il rollback delle immagini e il ripristino completo del database e della libreria.

Blocca lo stato di errore e individua il limite dell’aggiornamento

Disattiva i riavvii automatici e annota le immagini o i digest esatti dei servizi server, machine learning, database e cache. Salva i log di avvio e i file di distribuzione prima di eseguire un altro pull. L’operazione riesce se sai indicare cosa è cambiato; in caso contrario, la procedura di ripristino deve attendere finché non si riescono a identificare le vecchie versioni dalla cronologia delle distribuzioni o dalle immagini locali.

Verifica se il server si arresta prima di connettersi al database, durante una migrazione o dopo essere diventato operativo. Un errore di connessione a una dipendenza indica che occorre intervenire sulla rete, sulle credenziali o sullo stato di salute del servizio; un errore di migrazione aumenta il rischio di ripristinare solo l’immagine dell’app, perché il database potrebbe essere già stato modificato.

Una guida passo passo agli aggiornamenti di Immich con versioni specifiche spiega perché sono importanti i limiti tra le versioni e i file di distribuzione. Usala per ricostruire i passaggi, basandoti però sui tuoi log e backup per decidere come eseguire il rollback.

Prova prima un rollback completo alle immagini dell’ultima versione funzionante

Blocca tutte le immagini dell’applicazione Immich sulla versione esatta che funzionava in precedenza, invece di modificare un solo servizio. Ricrea i container interessati lasciando intatti i volumi persistenti. Se lo stack torna operativo e i log non mostrano incompatibilità dello schema, il rollback con modifiche minime è riuscito.

Se il vecchio server rifiuta lo schema del database attuale, fermati. Non alternare le versioni sullo stesso database e non modificare manualmente le tabelle delle migrazioni. Questo errore significa che l’aggiornamento ha oltrepassato un limite dei dati e il ripristino deve utilizzare un backup del database con un timestamp corrispondente alla versione dell’applicazione selezionata.

Una segnalazione relativa a Immich v1.135.3 documenta uno specifico errore di avvio durante la migrazione del database dopo un aggiornamento. Il suo esempio di migrazione circoscritto giustifica un’attenta lettura del primo errore fatale; non autorizza a copiare i comandi di quel caso in un’altra versione.

Ripristina il database e i contenuti multimediali solo se il rollback non consente il recupero

Prima di ripristinare, crea una copia di sicurezza o uno snapshot dello storage dello stato non riuscito. Prepara una destinazione di ripristino pulita, ripristina il backup del database, quindi rendi accessibile la libreria di caricamenti corrispondente e i file di distribuzione necessari. Non sovrascrivere l’unica libreria attuale con una copia più vecchia solo per far coincidere le date.

I record del database e i file degli elementi devono descrivere la stessa raccolta. Se il backup è precedente ai caricamenti più recenti, conserva separatamente questi file più recenti per riconciliarli in seguito. Il ripristino è riuscito quando le migrazioni vengono completate, compaiono gli utenti e gli elementi previsti e gli originali campionati si aprono senza errori diffusi di file mancanti.

La guida alla migrazione di Immich di ZimaSpace fornisce un utile inventario per spostare i componenti persistenti senza considerare l’immagine del container come se fosse la libreria di foto stessa.

Convalida il ripristino prima di riprovare l’aggiornamento

Verifica l’accesso, la navigazione della cronologia, il download degli originali, la generazione delle miniature, Smart Search, l’elaborazione dei volti, un nuovo caricamento e un backup del database. Riavvia una volta i container e l’host. Il test è superato se, dopo il riavvio, gli stessi elementi e le stesse funzioni sono disponibili e non si ripetono errori di migrazione o di autorizzazione.

Mantieni gli stati di errore e ripristino etichettati separatamente fino al termine della convalida. Se il ripristino dipende da una versione precedente, disattiva il download automatico delle immagini e documenta il blocco della versione. Riprova l’aggiornamento solo dopo aver esaminato tutte le versioni intermedie e aver creato un nuovo backup coordinato.

Torna all’ultimo obiettivo di ripristino conservato se un nuovo caricamento scompare, gli originali non si aprono o le attività si bloccano ripetutamente. Inoltra il problema indicando le versioni di origine e destinazione, gli hash delle immagini, il primo errore fatale nei log, la data e l’ora del backup del database e la mappatura dello storage; non eliminare l’ultima copia funzionante nota finché la compatibilità dell’aggiornamento non è stata verificata.

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.