Guida alla migrazione dei dataset ZFS: spostare i dati senza modificare i percorsi dei 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.

L'approccio sicuro consiste nel trattare replica, verifica e passaggio atomico al mountpoint originale, mantenendo un dataset di rollback, come una sequenza di verifiche osservabili e non come un unico comando.

Per un dataset ZFS che supporta lo stack di container di un home server, il rischio concreto è dover spostare un dataset ZFS preservando i percorsi dei bind mount usati dai container. Annota l'identità attuale e il punto di ripristino, inizia dal controllo meno invasivo, interpreta i risultati positivi e negativi prima di modificare un'altra variabile e fermati se lo storage diventa instabile o se rischi di esporre l'unica copia recuperabile. Il flusso di lavoro seguente si conclude solo quando il carico di lavoro originale funziona oppure quando le evidenze impongono un'escalation.

Fai l'inventario del dataset e dei percorsi previsti

Annota il dataset sorgente, i dataset figli, gli snapshot, il mountpoint, il valore di canmount, la radice di cifratura, le quote, le riserve, il comportamento degli ACL e ogni bind mount dei container che ricade al suo interno. Il vincolo è il percorso host visibile ai container; il nome del pool e del dataset può cambiare senza modificare quel percorso.

La replica ZFS può preservare snapshot e proprietà, quindi uno stream ricorsivo richiede un'analisi attenta delle proprietà, non una ricezione alla cieca. Una guida indipendente alla migrazione con ZFS Send e Receive mostra come usare send e receive per migrare dataset internamente e perché è opportuno ispezionare la gerarchia di destinazione prima del passaggio.

Crea un backup esterno aggiornato o verifica che un ripristino esistente funzioni prima della migrazione. Fermati se la sorgente contiene dataset figlio nascosti, una dipendenza da una chiave di cifratura sconosciuta o un mountpoint sovrapposto a un altro dataset attivo; queste condizioni possono far montare uno stream corretto nel posto sbagliato.

Ricevi la prima copia senza montarla sopra l'ambiente di produzione

Crea uno snapshot ricorsivo, ad esempio zfs snapshot -r oldpool/apps@move-0, quindi invialo a un dataset di destinazione ricevuto con il montaggio disabilitato o con un mountpoint temporaneo. Usa i flag appropriati per i requisiti di cifratura e delle proprietà; non dare per scontato che uno stream cifrato raw e una ricezione decifrata si comportino allo stesso modo con le chiavi.

Dopo la ricezione, confronta zfs list -r -t filesystem,snapshot e zfs get -r mountpoint,canmount,encryptionroot,quota,reservation su entrambi gli alberi. Una discussione sul forum relativa alle proprietà dei mountpoint replicate illustra perché queste possono riservare sorprese anche dopo una migrazione riuscita.

La prima copia è riuscita quando la discendenza del dataset e degli snapshot coincide e la destinazione resta isolata dal percorso di produzione. Se viene montata sopra la sorgente o modifica i file visibili ai container, esporta o smonta la destinazione e correggi le proprietà prima di qualsiasi invio incrementale.

Chiudi la finestra di scrittura e cambia il mountpoint

Crea un altro snapshot della sorgente e invia la differenza incrementale mentre l’app è ancora in esecuzione. Per il passaggio finale, arresta tutti i processi che scrivono, verifica che nessun processo abbia file aperti nel percorso del bind mount, crea uno snapshot finale e invia solo le differenze. Limita l’interruzione al tempo necessario per la sincronizzazione finale e la commutazione del percorso.

Imposta la sorgente su un mountpoint non di produzione oppure su canmount=noauto, quindi assegna il percorso host originale alla destinazione e montala. Non lasciare mai che due dataset rivendichino lo stesso mountpoint. Avvia il database e i servizi dipendenti prima del front end dell’applicazione, così gli errori indicano il livello corretto.

Se l’invio finale non riesce, monta di nuovo la sorgente nel percorso originale e riavvia lo stack; non distribuire le nuove scritture su entrambe le copie. La condizione per il rollback è esplicita: la sorgente resta intatta e non vengono accettate scritture di produzione sulla destinazione finché il flusso finale e i controlli delle proprietà non sono superati.

Convalida i container nel percorso invariato

Controlla i bind mount dal runtime dei container, apri alcuni file rappresentativi, crea ed elimina un file temporaneo tramite l’app e verifica proprietà, ACL, attributi estesi e spazio libero segnalato. Riavvia lo stack due volte e verifica che i mount ZFS vengano attivati prima dell’avvio dei container.

Esegui uno scrub o un altro controllo dello stato del pool secondo il piano di manutenzione, ma non considerarlo l’unica prova della migrazione. Confronta i GUID degli snapshot o un manifest di hash rappresentativo, ripristina un elemento di piccole dimensioni e verifica con il test di ZimaSpace se la replica ZFS può riprendere dopo un’interruzione, prima di dismettere la lineage della sorgente.

Mantieni la sorgente in sola lettura finché non vengono completati almeno un backup regolare e un ciclo dell’applicazione. Dismettela solo quando i container utilizzano i percorsi originali, le attività pianificate puntano al nuovo dataset, la replica prosegue dalla lineage prevista e non serve più poter eseguire il rollback; altrimenti ripristina il mountpoint e conserva entrambe le cronologie.

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.