Checklist per la migrazione dell'esportazione cloud di Immich per file sidecar e duplicati

Eva Wong è la Technical Writer e smanettatrice residente di ZimaSpace. Una geek da sempre con una passione per homelab e software open-source, si specializza nel tradurre concetti tecnici complessi in guide accessibili e pratiche. Eva crede che l'auto-ospitare debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, dà potere alla comunità di demistificare le configurazioni hardware, dalla costruzione del loro primo NAS al dominio dei container Docker.

Mantieni intatto l'export cloud originale finché Immich non avrà conservato i sidecar, le date, le relazioni e le versioni desiderate che puoi effettivamente verificare.

Un export di Google Foto o simile può contenere file JSON associati, riferimenti ripetuti agli album, duplicati rinominati, modifiche e file che si sovrappongono al backup successivo dello stesso telefono. Crea prima un manifest, importa un piccolo gruppo canary con ogni classe di conflitto e non appiattire le cartelle né eliminare la copia cloud finché un sidecar rimane ambiguo. La migrazione termina solo dopo che gli hash originali, le date della timeline, gli album e il primo test di sovrapposizione con il backup mobile coincidono.

Conserva l'export originale e crea un manifest di migrazione

Estrai ogni archivio in una struttura di staging di sola lettura e conserva gli archivi scaricati finché la migrazione non sarà accettata. Registra per ogni risorsa candidata il batch di export, il percorso relativo, il nome file, la dimensione in byte, l'hash, il tipo di file multimediale, i dati di acquisizione, il percorso del sidecar e la cartella dell'album. Questo manifest è il riferimento per il rollback quando due file hanno lo stesso nome ma contenuti diversi.

Una migrazione consapevole dei sidecar è importante perché un export cloud può conservare l'ora di acquisizione, la descrizione, la posizione e le relazioni con gli album al di fuori del file multimediale. Il flusso di lavoro dell'importer consapevole dell'export mostra perché utilizzare un importer consapevole dell'export e verificare la destinazione prima di eliminare la copia cloud preservi più di una semplice copia cieca dei file.

Fermati se l'estrazione degli archivi non riesce, mancano gli anni previsti, il numero di sidecar non è spiegato o il volume di staging non ha spazio per una copia di lavoro. Non rinominare, appiattire, deduplicare o riscrivere i metadati nell'unico export disponibile, perché tali modifiche distruggono le prove necessarie per associare in seguito i sidecar.

Associa i sidecar prima di normalizzare nomi o cartelle

Raggruppa i file multimediali e i JSON in base alle regole di denominazione dell'exporter, inclusi i suffissi aggiunti a duplicati, modifiche e nomi file lunghi. Per dieci elementi rappresentativi, confronta l'ora di acquisizione incorporata con l'ora della foto nel sidecar, l'ora di modifica del file system, il fuso orario, la descrizione, la posizione e l'appartenenza agli album. Registra quale campo diventerà autorevole per ogni classe di conflitto.

Usa una copia di lavoro per qualsiasi fusione dei metadati e conserva il sidecar originale accanto a essa. Un flusso di lavoro ZimaSpace per impedire ai sidecar di modificare le date di acquisizione fornisce il relativo percorso di conservazione delle date; questa checklist aggiunge il manifest e i controlli sui duplicati necessari prima di un'importazione completa in Immich.

La fase è superata solo quando ogni sidecar canary è associato a un unico file multimediale previsto oppure è esplicitamente classificato come non associato. Se un file rinominato potrebbe corrispondere a più di un sidecar, lascialo irrisolto e analizza la sequenza dell'exporter e gli hash invece di scegliere basandoti solo sul nome file.

Separa i veri duplicati dalle versioni correlate

Classifica i conflitti come copie identiche a livello di byte, copie ridimensionate dal cloud, versioni modificate, riferimenti agli album, coppie Live Photo o immagini realmente diverse con lo stesso nome. Conserva le versioni modificate e originali a meno che il gruppo non abbia scelto una regola documentata; una somiglianza visiva non è una prova sufficiente per eliminare un file.

Un caso risolto dalla community su cronologia cloud e nuovo backup del telefono mostra come la cronologia cloud e un nuovo backup del telefono possano creare duplicati con hash diversi. Usa questo scenario di errore circoscritto per testare la sovrapposizione tra il set di Takeout e ogni rullino della fotocamera del telefono prima di abilitare il caricamento automatico.

Importa un piccolo gruppo canary contenente ogni classe di duplicato. Confronta i conteggi di origine e destinazione, gli hash, le date, le posizioni, l'appartenenza agli album e il comportamento delle coppie video. Esegui il rollback del canary se l'importer accorpa versioni desiderate o crea una seconda risorsa senza spiegazione; non cercare di rimediare in seguito con un'eliminazione di massa.

-15% OFF

Esegui l'importazione completa e dimostra quale sia la nuova fonte autorevole

Blocca la riscrittura dei metadati e il backup mobile durante l'importazione dei batch identificati dal manifest. Salva i log dell'importer e gli elenchi dei file rifiutati, quindi riconcilia i conteggi per classe invece di aspettarti che un unico numero grezzo corrisponda a un altro quando i riferimenti agli album e i duplicati identici vengono intenzionalmente accorpati.

Dopo l'importazione, esegui controlli a campione sugli anni passati e recenti, sulle foto modificate, sui video lunghi, sulle Live Photo, sugli elementi degli album condivisi e sulle risorse con sidecar. Scarica gli originali selezionati e confronta gli hash con la copia nell'area di staging; verifica le date della timeline, la ricerca, l'appartenenza agli album e la posizione sia sui client web sia su quelli mobili.

Abilita il backup di un solo telefono dopo che la cronologia importata avrà superato i controlli. Ripeti il test di sovrapposizione, riavvia Immich e verifica che non compaiano seconde copie. Conserva l'export originale e la libreria cloud finché due cicli di backup e un test di ripristino non avranno esito positivo; segnala i sidecar non associati o la gestione non deterministica dei duplicati mantenendo intatti il manifest e i log del canary.

Supporto e consigli

Altro da leggere

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.