Perché il ripristino di un volume Docker ricrea il contenuto dei file ma perde gli attributi estesi?

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.

Il ripristino di un volume Docker può ricreare ogni byte dei file e tuttavia perdere gli attributi estesi, se il formato di backup, le opzioni, i privilegi o la destinazione non consentono di conservarli.

Gli attributi estesi sono coppie nome-valore di metadati memorizzate separatamente dai normali contenuti dei file, dalla proprietà, dai bit di modalità e dai timestamp. Possono contenere dati ACL, etichette SELinux, funzionalità Linux, indicatori applicativi o metadati Samba. Un semplice backup di un volume basato su tar può ripristinare una directory che sembra completa, mentre le applicazioni si comportano diversamente perché l’archivio non ha registrato gli xattr o il processo di ripristino non ha potuto scrivere in un namespace protetto.

Fai l’inventario degli attributi della sorgente prima di ripetere il ripristino

Seleziona file rappresentativi e annota i loro hash, proprietario, modalità, ACL e tutti i nomi e i valori degli attributi estesi. Includi i file che non funzionano nell’applicazione dopo il ripristino.

Il modello xattr di Linux distingue i namespace user, system, security e trusted, ciascuno con requisiti di accesso e privilegi diversi.

Se la sorgente non contiene xattr, il ripristino non li ha persi. Se scompare un solo namespace, concentrati sui privilegi, sui criteri di sicurezza o sul supporto della destinazione, anziché sul livello dei contenuti dei file dell’archivio.

Verifica cosa ha effettivamente archiviato il comando di backup di Docker

Salva l’immagine esatta, il comando, la directory di lavoro, il formato dell’archivio, l’utente, la sorgente montata e la destinazione di backup montata usati dal container di backup.

L’esempio di backup dei volumi di Docker usa tar all’interno di un container di supporto, ma la conservazione dei metadati dipende comunque dall’implementazione di tar e dalle opzioni selezionate.

Un file di archivio creato correttamente dimostra che le voci delle directory e i dati sono stati letti, non che siano stati inclusi tutti i namespace degli xattr. Esamina l’archivio con lo stesso strumento usato per crearlo.

Abilita gli attributi estesi durante la creazione e l’estrazione dell’archivio

Confronta le opzioni di tar usate per il backup e il ripristino. Verifica che gli xattr fossero abilitati in entrambe le direzioni e che i pattern di inclusione o esclusione non abbiano rimosso namespace necessari.

GNU tar afferma che --xattrs archivia e ripristina gli attributi estesi.

Aggiungere l'opzione solo durante l'estrazione non consente di recuperare attributi mai archiviati. Crea un nuovo piccolo archivio a partire da un file sorgente con uno xattr di prova noto e controllalo prima di modificare i backup di produzione.

Usa le opzioni corrette di Rsync per i metadati nei backup basati su file

Se il backup del volume usa Rsync, controlla le opzioni di archiviazione, ACL, xattr, ID numerici, fake-super e privilegi sia sul mittente sia sul destinatario.

Il manuale ufficiale di Rsync documenta -X per la conservazione degli attributi estesi e descrive l'archiviazione fake-super per i casi in cui i metadati privilegiati non possono essere applicati direttamente.

La comune opzione di archiviazione -a non include automaticamente tutti i requisiti relativi ad ACL e xattr. Prova il comando esatto con i filesystem di origine e destinazione effettivi.

Verifica il supporto del filesystem di destinazione e del mount

Crea un file temporaneo direttamente sul volume ripristinato e prova a impostare, elencare e rimuovere uno xattr utente. Ripeti la prova tramite l'host e il container di backup.

Usa un'utilità per elencare gli attributi sia sull'host sia nel container di ripristino, per verificare se la destinazione accetta e restituisce xattr, indipendentemente dall'archivio di backup.

Se la creazione diretta degli xattr non riesce, controlla il tipo di filesystem, le opzioni di mount, il protocollo di rete, il driver del volume e il supporto dell'appliance di storage. Nessuna opzione di archiviazione può ripristinare metadati che la destinazione non è in grado di rappresentare.

Controlla i privilegi di sicurezza e gli spazi dei nomi attendibili

Annota l'utente del container che esegue il ripristino, le capability, lo spazio dei nomi utente, la modalità rootless, i criteri SELinux e se il percorso del volume è montato tramite bind dall'host.

Red Hat documenta che potrebbe essere necessario ripristinare le etichette SELinux in modo conforme ai criteri dopo la copia o la ricreazione dei file.

Non concedere in modo permanente privilegi estesi sull’host a un container di backup. Usa un ambiente di ripristino controllato oppure ripristina prima i dati ordinari e riapplica le etichette gestite dalle policy con gli strumenti supportati.

Separa ACL, capability e xattr specifici delle applicazioni

Confronta separatamente le voci ACL POSIX, le capability dei file Linux, le etichette SELinux, gli xattr utente e i metadati Samba o macOS. Possono avere problemi per motivi diversi.

Il modulo xattr_tdb di Samba può archiviare gli xattr separatamente dal filesystem sottostante.

Un archivio a livello di file del volume potrebbe quindi conservare l’albero dei file visibile, ma non un database dei metadati Samba separato. Includi tutti gli archivi di metadati da cui dipende il sistema oppure ricreali tramite la procedura supportata dall’applicazione.

Ripristina un file di prova e verifica l’applicazione

Crea un file sorgente di prova con un hash del contenuto, un ACL, uno xattr utente e tutti i metadati applicativi necessari. Esegui il backup e ripristinalo in un volume temporaneo.

L’articolo di ZimaSpace sulle modifiche alle autorizzazioni e ai metadati del NAS approfondisce il comportamento generale durante la migrazione; questo articolo si concentra sui backup e sui ripristini dei volumi Docker.

Il problema è risolto quando gli hash dei contenuti, i nomi e i valori degli xattr richiesti, gli ACL, le etichette di sicurezza e il comportamento dell’applicazione coincidono tutti dopo un secondo backup e ripristino controllati.

Domande frequenti

Gli attributi estesi sono la stessa cosa degli ACL?

No. In alcuni filesystem, gli ACL possono essere implementati usando gli xattr di sistema, ma gli xattr memorizzano anche etichette di sicurezza, capability, metadati utente e valori specifici delle applicazioni.

tar conserva gli attributi estesi per impostazione predefinita?

Non darlo per scontato. GNU tar offre opzioni esplicite per gli xattr e l’archivio deve memorizzare gli attributi durante la creazione affinché possano essere ripristinati in fase di estrazione.

Un ripristino può perdere gli xattr anche se viene eseguito come root?

Sì. L’archivio potrebbe non contenerli, la destinazione potrebbe non supportarli, una policy di sicurezza potrebbe rifiutarli oppure i metadati potrebbero trovarsi in un database applicativo separato.

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.