Cómo solucionar un montaje bind de Docker que de repente se vuelve de solo lectura

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Un montaje bind de Docker pasa a ser de solo lectura cuando Docker recibe una ruta de solo lectura o el sistema de archivos del host deja de aceptar escrituras.

Como un montaje bind expone una ruta del host directamente dentro del contenedor, el contenedor no puede reparar por sí solo un disco, sistema de archivos, marca de montaje o política de seguridad subyacentes. La recuperación más segura consiste en detener las escrituras, comparar el montaje del contenedor con el del host, determinar si el comportamiento de solo lectura se configuró o se activó por un error y restablecer el buen estado del almacenamiento antes de reiniciar la aplicación.

Confirma qué ruta es de solo lectura

Prueba a escribir algo inocuo dentro del contenedor en el destino del montaje bind y, por separado, en el host, en la ruta de origen. Registra el error exacto en vez de suponer que todo error de permisos significa que el sistema de archivos es de solo lectura.

Un caso del foro de Docker muestra que un montaje bind de un directorio superior de solo lectura puede impedir que Docker cree un punto de montaje anidado, porque no se puede crear el directorio necesario en el sistema de archivos de solo lectura del directorio superior.

Si el host puede escribir, pero el contenedor no, inspecciona las opciones de montaje de Docker y los controles de seguridad. Si ambos fallan con un error de sistema de archivos de solo lectura, deja de cambiar los usuarios del contenedor y centra el diagnóstico en el montaje del host y el dispositivo de almacenamiento.

Comprueba las marcas efectivas de montaje de Docker

Inspecciona la configuración del contenedor en ejecución, no solo el archivo de Compose actual. Confirma el origen, el destino, el modo de propagación y si el montaje está marcado como de solo lectura mediante :ro, la sintaxis larga, un archivo de sobrescritura o una herramienta de despliegue.

Un problema de cliente de Docker documenta casos en los que las rutas montadas parecían de solo lectura porque la configuración del entorno de ejecución difería de la configuración prevista de lectura y escritura. La prueba importante es el modo de montaje efectivo del contenedor en ejecución.

Si el montaje está configurado intencionalmente como de solo lectura, quita esa marca únicamente cuando la aplicación realmente necesite escribir. Vuelve a crear el contenedor después de cambiar la declaración, porque editar un archivo de Compose no modifica retroactivamente un montaje existente.

Determina si el host volvió a montar el sistema de archivos como de solo lectura

Revisa la tabla de montajes del host, el registro del kernel, el registro de almacenamiento y el estado del sistema de archivos para detectar errores de E/S, fallos del diario, errores de suma de comprobación, restablecimientos del dispositivo o un remontaje de protección. No fuerces un remontaje con permisos de lectura y escritura antes de entender por qué se activó la protección.

Un caso de soporte de Unraid describe cómo fallaron los datos de aplicaciones de Docker después de que un sistema de archivos pasara a ser de solo lectura, incluidos errores al crear directorios de Plex. Ese patrón apunta a un fallo del sistema de archivos del host, no a una configuración de permisos del contenedor.

Detén los contenedores afectados y conserva los diagnósticos. Repara el disco, el grupo de almacenamiento, el cable, el sistema de archivos o el diario siguiendo el procedimiento de mantenimiento compatible con la plataforma; luego confirma que la ruta del host esté en buen estado antes de permitir que las bases de datos o los contenedores multimedia vuelvan a escribir.

Inspecciona los montajes anidados y superpuestos

Enumera todos los montajes bind y volúmenes con nombre cuyo destino se encuentre dentro de otro directorio montado. Los montajes superpuestos pueden ocultar directorios, heredar comportamientos de acceso inesperados o exigir que Docker cree un punto de montaje bajo un directorio principal de solo lectura.

Un debate de Server Fault explica que superponer un montaje de lectura y escritura y otro más amplio de solo lectura en rutas relacionadas del contenedor puede dar resultados confusos. Como ese dominio ya se usa en otra parte de este lote, la regla práctica aquí es asignar todo el árbol de destinos antes de cambiar los permisos.

Crea los directorios necesarios en el host antes de iniciar el contenedor, evita montar un directorio secundario con permisos de escritura dentro de un directorio principal de solo lectura cuando el entorno de ejecución tenga que crearlo y especifica claramente las rutas persistentes en Compose. Recrea el contenedor después de simplificar el árbol de montajes.

Distingue el estado de solo lectura de los permisos y las políticas de seguridad

Compara el error de la prueba de escritura con el propietario, los permisos, las ACL y la etiqueta SELinux del directorio de origen, el perfil de AppArmor y el ID de usuario del contenedor. «Permiso denegado» y «sistema de archivos de solo lectura» son fallos distintos que requieren reparaciones diferentes.

Una guía de solución de problemas de almacenamiento clasifica los incidentes de volúmenes de solo lectura en indicadores de montaje, errores del sistema de archivos, contextos de seguridad y problemas con el controlador de almacenamiento. Esta clasificación ayuda a evitar recurrir a ciegas a chmod 777 ante un estado de solo lectura en la capa de almacenamiento.

Si los permisos son incorrectos, corrige la propiedad o las ACL en el host usando el UID y el GID previstos para el contenedor. Si el sistema de archivos es de solo lectura, los cambios de permisos fallarán y no deben usarse como sustituto de la reparación del sistema de archivos.

Reinicia la aplicación solo después de que la prueba de escritura en el host haya dado resultado satisfactorio

Escribe, sincroniza, lee y elimina un archivo temporal en la ruta del host; luego repite la prueba con un contenedor de corta duración usando la misma declaración de montaje y el mismo usuario. Confirma que el sistema de archivos esperado siga montado después de reiniciar.

La guía de ZimaSpace para encontrar una dependencia que reinicia un contenedor es el siguiente paso si la aplicación sigue reiniciándose en bucle después de que el almacenamiento pasa a ser de escritura.

La reparación solo está completa cuando el sistema de archivos del host está en buen estado, el montaje efectivo de Docker es de lectura y escritura por diseño, la aplicación puede actualizar sus archivos persistentes y no aparecen nuevos errores de E/S o del sistema de archivos con un uso sostenido.

Soporte y consejos

Más para leer

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.