Perché uno stack Compose collega un nuovo volume denominato vuoto dopo la ridistribuzione?

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.

Una stack Compose può collegare un nuovo volume nominato vuoto quando la ridistribuzione cambia il nome del volume definito in base al progetto o non riesce a trovare il volume originale.

I vecchi dati potrebbero essere ancora presenti in un altro volume Docker, mentre il servizio ricreato monta un volume appena generato nello stesso percorso del container. Tra le cause più comuni ci sono il cambiamento del nome dello stack o del progetto, la modifica della chiave del volume, la rimozione con un comando che elimina i volumi, la perdita di una dichiarazione di volume esterno, la distribuzione tramite un altro gestore o un nome esplicito del volume che ora viene risolto diversamente. Fai l'inventario sia del volume montato sia dei possibili volumi orfani prima di ripristinare i dati o inizializzare l'app.

Individua il volume esatto montato dal nuovo container

Esamina i montaggi del container in esecuzione e annota il nome del volume, il driver, il punto di montaggio, le etichette, l'ora di creazione, la destinazione nel container e la modalità di lettura e scrittura. Confrontali con i dati registrati prima della ridistribuzione.

Il comando docker volume inspect di Ubuntu espone l'identità del volume, consentendo di distinguere il nuovo volume vuoto da un volume precedente non montato con un nome simile.

Non copiare i dati nel nuovo volume finché non hai trovato quello originale. L'avvio dell'app può creare un nuovo database e far sembrare che la destinazione sia stata inizializzata intenzionalmente.

Verifica se è cambiato il nome del progetto Compose

Confronta il vecchio e il nuovo nome del progetto, il nome dello stack, la directory Compose, l'opzione -p, COMPOSE_PROJECT_NAME, il campo name: di primo livello e il gestore della distribuzione.

Docker spiega che normalmente Compose assegna a un volume un nome composto da nome del progetto più chiave del volume, a meno che non sia configurato un nome esplicito o la ricerca di un volume esterno.

Spostare lo stesso file Compose in un'altra directory può quindi creare un secondo progetto e un secondo volume, anche se le chiavi del servizio e del volume non cambiano.

Verifica il nome stabile e le impostazioni del volume esterno

Confronta la definizione del volume di primo livello prima e dopo il nuovo deployment. Controlla name:, external:, le opzioni del driver, le variabili di interpolazione e verifica se il volume previsto esiste.

Il tutorial di Microsoft su Docker Compose osserva che i volumi denominati persistono indipendentemente dalla sostituzione dei container; quindi, la presenza di un nuovo stato vuoto di solito significa che è stata collegata un'identità di volume diversa o che il vecchio volume è stato rimosso.

Contrassegna un volume come esterno solo quando il suo ciclo di vita è gestito intenzionalmente al di fuori dello stack. Compose dovrebbe segnalare chiaramente un errore se un volume esterno è assente, anziché crearne silenziosamente uno sostitutivo.

Verifica se una pulizia ha rimosso il volume originale

Esamina i log di deployment, gli script, le azioni dell'interfaccia utente, i processi di pruning e i comandi per l'eliminazione dei volumi. Confronta l'ora di creazione del volume con l'evento di nuovo deployment.

Red Hat documenta che i volumi denominati gestiti dai container hanno posizioni di archiviazione separate dai livelli scrivibili dei container; per questo, rimuovere un container e rimuovere il suo volume denominato sono eventi distinti del ciclo di vita.

Se il volume originale non è presente, interrompi gli avvii automatici e ripristina solo da un backup verificato. Non presumere che un volume sostitutivo vuoto contenga un livello eliminato recuperabile.

Confronta l'identità dello stack e il metodo di deployment

Annota se lo stack è stato avviato tramite CLI, Portainer, un app store NAS, un deployment Git o un altro strumento di automazione. Confronta il nome dello stack e i valori dell'ambiente memorizzati dal gestore.

Portainer richiede un nome descrittivo per lo stack al momento del deployment, e l'identità controllata dal gestore può differire dal nome del progetto basato sulla directory usato da un comando Compose manuale.

Un avvio di emergenza manuale può quindi creare risorse con il prefisso di un altro progetto. Scegli un unico responsabile del deployment e documenta i nomi dei volumi che crea.

Escludere la presenza di dati nascosti sotto il nuovo mount del volume

Arresta il container e, in un test usa e getta, ispeziona l'immagine o il percorso bind senza collegare il volume denominato. Determina se l'avvio ha scritto dati nel livello del container prima che venisse montato il volume.

Il manuale di mount di Linux spiega che un mount nasconde i contenuti preesistenti della directory; i dati possono quindi sembrare mancanti quando un nuovo volume vuoto copre i file creati nell'immagine o nel livello scrivibile.

Non unire alla cieca il livello nascosto e il vecchio volume persistente. Individua quale stato è quello autorevole e usa il metodo di ripristino supportato dall'applicazione.

Ricollegare il volume originale con un test controllato

Arresta lo stack, esegui il backup di entrambi i volumi candidati, collega quello originale a un container usa e getta o a un percorso di servizio temporaneo, quindi verifica i file dell'applicazione, l'identità del database, la proprietà e i timestamp.

La guida di ZimaSpace a spostare i dati dei container senza compromettere i mount illustra il flusso di lavoro correlato per la mappatura dei percorsi; questo articolo si concentra sull'identità dei volumi denominati con ambito limitato al progetto.

Il problema è risolto quando il volume originale desiderato viene montato con un nome esplicito o esterno stabile e le distribuzioni successive lo riutilizzano senza crearne un altro vuoto.

Domande frequenti

Un volume denominato vuoto significa che i vecchi dati sono stati eliminati?

Non necessariamente. Il vecchio volume potrebbe esistere ancora con un altro prefisso di progetto o un nome esplicito, mentre il nuovo container usa un volume vuoto diverso.

Cambiare il nome della cartella di Compose può creare un nuovo volume?

Sì. Se non è impostato un nome fisso per il progetto, Compose può ricavarlo dalla directory del progetto e creare risorse con prefissi diversi.

I volumi importanti dovrebbero essere contrassegnati come esterni?

I volumi esterni possono impedire a Stack di gestire il loro ciclo di vita, ma richiedono creazione, denominazione, backup e controlli di distribuzione accurati.

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.