Come risolvere un bind mount Docker che diventa improvvisamente di sola lettura

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 bind mount Docker diventa di sola lettura quando Docker riceve un percorso di sola lettura o il filesystem dell’host smette di accettare scritture.

Poiché un bind mount espone direttamente un percorso host all’interno del container, il container non può riparare da solo un disco, un filesystem, un flag di mount o una policy di sicurezza sottostante. Il ripristino più sicuro consiste nell’interrompere le scritture, confrontare il mount del container con quello dell’host, determinare se il comportamento di sola lettura è stato configurato o attivato da un errore e ripristinare l’integrità dello storage prima di riavviare l’applicazione.

Verifica quale percorso è di sola lettura

Prova una scrittura innocua nel container sulla destinazione del bind mount e un’altra scrittura sull’host nel percorso di origine. Registra l’errore esatto invece di presumere che ogni problema di permessi indichi un filesystem di sola lettura.

Un caso discusso in un forum Docker mostra che un bind mount genitore in sola lettura può impedire a Docker di creare un punto di mount annidato, perché non è possibile creare la directory necessaria sul filesystem genitore di sola lettura.

Se l’host può scrivere ma il container no, controlla le opzioni di mount Docker e i controlli di sicurezza. Se entrambi falliscono con un errore di filesystem di sola lettura, smetti di modificare gli utenti del container e sposta la diagnosi sul mount dell’host e sul dispositivo di storage.

Controlla i flag di mount Docker effettivi

Esamina la configurazione del container in esecuzione, non solo il file Compose attuale. Verifica l’origine, la destinazione, la modalità di propagazione e se il mount è contrassegnato come di sola lettura tramite :ro, la sintassi estesa, un file di override o uno strumento di deployment.

Un problema segnalato per il client Docker documenta casi in cui i percorsi montati risultavano di sola lettura perché la configurazione runtime era diversa da quella prevista in lettura-scrittura. L’elemento importante è la modalità di mount effettiva applicata al container in esecuzione.

Se il mount è intenzionalmente in sola lettura, rimuovi quel flag solo se l’applicazione ha davvero bisogno di scrivere. Ricrea il container dopo aver modificato la dichiarazione, perché modificare un file Compose non cambia retroattivamente un mount esistente.

Determina se l’host ha rimontato il filesystem in sola lettura

Controlla la tabella dei mount dell’host, il log del kernel, il log dello storage e lo stato del filesystem per rilevare errori di I/O, problemi del journal, errori di checksum, reset del dispositivo o un remount di protezione. Non forzare un remount in lettura-scrittura prima di aver capito perché è stata attivata la protezione.

Un caso di assistenza Unraid descrive il mancato funzionamento dei dati delle app Docker dopo che un filesystem è diventato di sola lettura, con errori durante la creazione delle directory di Plex. Questo schema indica un problema del filesystem host, non un’impostazione dei permessi del container.

Arresta i container interessati e conserva i dati diagnostici. Ripara il disco, il pool, il cavo, il filesystem o il journal seguendo il flusso di manutenzione supportato dalla piattaforma, quindi verifica che il percorso dell’host sia integro prima di consentire nuovamente la scrittura ai container di database o multimediali.

Esamina i mount annidati e sovrapposti

Elenca ogni bind mount e volume denominato la cui destinazione si trova all’interno di un’altra directory montata. I mount sovrapposti possono nascondere directory, ereditare comportamenti di accesso imprevisti o richiedere a Docker di creare un punto di mount sotto una directory padre in sola lettura.

Una discussione su Server Fault spiega che sovrapporre un mount in lettura-scrittura e un mount più ampio in sola lettura in percorsi correlati del container può produrre risultati poco chiari. Poiché quel dominio è già usato altrove in questo gruppo, la regola pratica è mappare l’intero albero di destinazione prima di modificare le autorizzazioni.

Crea le directory richieste sull’host prima di avviare il container, evita di montare una directory figlia scrivibile sotto una directory padre in sola lettura quando il runtime deve crearla e indica esplicitamente i percorsi persistenti in Compose. Ricrea il container dopo aver semplificato l’albero dei mount.

Distingui lo stato di sola lettura da autorizzazioni e criteri di sicurezza

Confronta l’errore del test di scrittura con il proprietario, i permessi, gli ACL, l’etichetta SELinux, il profilo AppArmor e l’ID utente del container della directory di origine. «Accesso negato» e «filesystem in sola lettura» sono errori diversi e richiedono interventi diversi.

Una guida alla risoluzione dei problemi di storage suddivide gli incidenti dei volumi in sola lettura in flag di mount, errori del filesystem, contesti di sicurezza e problemi del driver di storage. Questa classificazione aiuta a evitare di ricorrere alla cieca a chmod 777 in caso di stato di sola lettura a livello di storage.

Se le autorizzazioni sono errate, correggi la proprietà o gli ACL sull’host usando gli UID e GID previsti per il container. Se il filesystem è in sola lettura, le modifiche alle autorizzazioni non riusciranno e non devono essere usate al posto della riparazione del filesystem.

Riavvia l’applicazione solo dopo aver superato un test di scrittura sull’host

Crea, sincronizza, leggi ed elimina un file temporaneo nel percorso dell’host, quindi ripeti l’operazione tramite un container di test di breve durata usando la stessa dichiarazione di mount e lo stesso utente. Verifica che il filesystem previsto resti montato dopo un riavvio.

La guida di ZimaSpace per individuare una dipendenza che causa il riavvio di un container è il passaggio successivo se l’applicazione continua a riavviarsi dopo che lo storage è diventato scrivibile.

La riparazione è completa solo quando il filesystem dell’host è integro, il mount Docker effettivo è in lettura-scrittura per progettazione, l’applicazione può aggiornare i propri file persistenti e non compaiono nuovi errori di I/O o del filesystem durante l’uso prolungato.

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.