Come ripristinare un database Immich da un backup noto come integro

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.

Un backup del database di Immich noto come integro รจ utile solo se lo ripristini in uno stato controllato e verifichi che il database recuperato faccia ancora riferimento ai file multimediali effettivamente accessibili al tuo server.

Considera il ripristino come una sequenza di passaggi, non come un singolo comando di importazione. Innanzitutto preserva lโ€™istanza guasta, individua la versione di Immich e la data e lโ€™ora del backup, avvia una destinazione pulita con un database compatibile, ripristina i dati senza consentire prima allโ€™applicazione di scrivere in uno schema vuoto, poi convalida gli account, i dati della cronologia, i percorsi dei file multimediali e una nuova scrittura. Se un passaggio non รจ chiaro, fermati prima di sostituire lโ€™ultima copia recuperabile.

Congela lo stato guasto prima di ripristinare qualsiasi cosa

Interrompi i nuovi caricamenti e le scritture in background nellโ€™istanza Immich interessata prima di iniziare il ripristino. Se lo spazio di archiviazione lo consente, salva il file Compose attuale, i valori delle variabili di ambiente, i percorsi montati, le versioni delle immagini, i log recenti e lo stato danneggiato del database. Anche un database guasto puรฒ contenere indizi su cosa รจ successo e sovrascriverlo li elimina.

Individua esattamente quale backup intendi considerare attendibile. Annota la data e lโ€™ora, come รจ stato creato, le dimensioni del file e se รจ mai stato usato per un ripristino di prova. Un dump SQL prodotto dal database รจ una risorsa di ripristino diversa da una copia grezza della directory dei dati PostgreSQL in uso: non considerarli intercambiabili.

Crea la destinazione del ripristino in una directory separata o in uno stack isolato, quando possibile. La condizione per concludere questa fase รจ semplice: lo stato originale dopo il guasto รจ preservato, il backup scelto รจ di sola lettura e sai a quale versione della distribuzione e a quali percorsi di archiviazione deve ricollegarsi il ripristino.

Verifica che il backup sia davvero ripristinabile

Esamina il backup prima di ripristinarlo. Un dump SQL compresso dovrebbe decomprimersi senza errori e contenere dati riconoscibili di un dump PostgreSQL, anzichรฉ essere un archivio vuoto prodotto da una pipeline non riuscita. Se hai checksum o risultati di verifica del repository, confrontali ora, invece di scoprire che i dati sono corrotti a metร  del ripristino.

Un dump di PostgreSQL รจ una risorsa di ripristino piรน sicura di una copia improvvisata di una directory del database in uso, perchรฉ viene creato con strumenti specifici per i database e puรฒ essere importato in un ambiente di destinazione pulito. Anche il metodo di backup con dump del database mantiene il database separato dalla copia dei file multimediali, facilitando la convalida di entrambe le parti prima del ripristino.

Verifica anche che i file multimediali e la configurazione relativi al periodo del backup siano ancora disponibili. Il solo ripristino del database puรฒ recuperare utenti, album, metadati e riferimenti ai file, ma lasciare tutte le risorse non funzionanti se i percorsi della libreria a cui fanno riferimento non sono presenti. Procedi solo quando il dump e lโ€™insieme di file multimediali e configurazione appartengono a un punto di ripristino noto.

Avvia prima un database di destinazione pulito e compatibile

Scegli il metodo di ripristino in base alla versione che ha creato il backup. Le versioni attuali di Immich consentono di ripristinare il database da Amministrazione > Manutenzione e dalla procedura guidata di configurazione iniziale, mentre per i backup meno recenti potrebbero essere necessarie istruzioni manuali specifiche per la versione; la procedura di ripristino รจ cambiata in v2.5.0.

Per un ambiente di ripristino nuovo, non consentire a Immich di eseguire le migrazioni normali su uno schema vuoto prima che il ripristino del database sia pronto. Se il metodo di distribuzione avvia lโ€™applicazione insieme a PostgreSQL, usa le opzioni di ripristino appropriate per la versione, cosรฌ che il server non crei uno stato concorrente prima dellโ€™importazione.

Se il database non torna operativo da solo, fermati e risolvi prima il problema. Non continuare a importare lo stesso backup in un ambiente di destinazione che si riavvia, ha esaurito lo spazio su disco o usa un layout di archiviazione incompatibile. Un ambiente di destinazione pulito e stabile รจ un prerequisito, non una deviazione per la risoluzione dei problemi.

Ripristina il dump una sola volta e fermati al primo errore

Ripristina il dump scelto nel database preparato e registra l'intero output. Usa gli strumenti e le opzioni appropriati al formato del dump, in modo che un errore faccia fallire visibilmente il ripristino, invece di lasciare uno schema importato solo in parte che riesce comunque ad avviarsi.

Per una migrazione utilizzabile servono i file multimediali, lo stato di PostgreSQL e la configurazione che li collega. Un set completo di backup di Immich comprende i file caricati, un backup del database in un formato supportato e la configurazione dell'installazione; un test di ripristino serve a verificare che il set funzioni. Tieni insieme questi elementi, cosรฌ la destinazione potrร  essere associata a un unico punto di ripristino.

Dopo un'importazione riuscita, avvia l'applicazione Immich e osserva attentamente il primo avvio. Se l'interfaccia ti chiede di creare un nuovo amministratore iniziale invece di accettare gli account esistenti, fermati: questo indica fortemente che il database ripristinato non รจ quello utilizzato da Immich. Non iniziare a ricaricare foto in quello stato vuoto.

Convalida lo stato del database, i percorsi dei file multimediali e una nuova scrittura

Accedi con un account esistente e controlla la cronologia in date sia passate sia recenti. Apri alcuni originali, controlla gli album o i preferiti che sai essere esistiti e verifica che l'applicazione riesca a individuare i file sottostanti, anzichรฉ limitarsi a mostrare le righe del database.

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 se PostgreSQL si avvia.

Carica infine una foto usa e getta, attendi che venga elaborata normalmente, verifica che sia ancora presente dopo un riavvio di Immich e un riavvio dell'host, quindi eliminala tramite l'applicazione. Se gli account, i vecchi contenuti e la nuova scrittura funzionano normalmente, crea un nuovo backup dello stato ripristinato prima di qualsiasi aggiornamento di versione. In caso contrario, torna alle prove del guasto conservate o a un backup precedente noto come funzionante, invece di aggravare il danno.

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.