¿Por qué una pila de Compose se conecta a un nuevo volumen con nombre vacío después de volver a implementarla?

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.

Una pila de Compose puede asociarse a un nuevo volumen con nombre vacío si el nuevo despliegue cambia el nombre del volumen asociado al proyecto o no encuentra el volumen original.

Es posible que los datos antiguos sigan en otro volumen de Docker, mientras que el servicio recreado monta un volumen nuevo generado en la misma ruta del contenedor. Entre las causas habituales están el cambio del nombre de la pila o del proyecto, el cambio de nombre de la clave del volumen, su eliminación mediante un comando que borra volúmenes, la pérdida de una declaración de volumen externo, el despliegue con otro administrador o un nombre explícito de volumen que ahora se resuelve de otra manera. Inventaría tanto el volumen montado como los posibles volúmenes huérfanos antes de restaurar los datos o inicializar la aplicación.

Identifica el volumen exacto montado por el nuevo contenedor

Inspecciona los montajes del contenedor en ejecución y anota el nombre del volumen, el controlador, el punto de montaje, las etiquetas, la fecha de creación, la ruta de destino en el contenedor y el modo de lectura y escritura. Compáralos con los registros previos al nuevo despliegue.

El comando docker volume inspect de Ubuntu muestra la identidad del volumen, lo que permite distinguir el nuevo volumen vacío de un volumen anterior sin montar con un nombre parecido.

No copies los datos al nuevo volumen hasta encontrar el original. Al iniciar la aplicación, se puede crear una base de datos nueva y hacer que el destino parezca inicializado intencionalmente.

Comprueba si cambió el nombre del proyecto de Compose

Compara el nombre del proyecto anterior y el nuevo, el nombre de la pila, el directorio de Compose, la opción -p, COMPOSE_PROJECT_NAME, name: de nivel superior y el administrador de despliegue.

Docker explica que, normalmente, Compose asigna al volumen el nombre nombre-del-proyecto más clave-del-volumen, a menos que se configure un nombre explícito o una búsqueda de volumen externo.

Por tanto, mover el mismo archivo Compose a otro directorio puede crear un segundo proyecto y un segundo volumen, aunque las claves del servicio y del volumen no cambien.

Verifica el nombre estable y la configuración del volumen externo

Compara la definición del volumen de nivel superior antes y después del nuevo despliegue. Comprueba name:, external:, las opciones del controlador, las variables de interpolación y si existe el volumen esperado.

El tutorial de Docker Compose de Microsoft señala que los volúmenes con nombre persisten independientemente de la sustitución de contenedores, por lo que un estado nuevo y vacío suele indicar que se conectó una identidad de volumen distinta o que se eliminó el volumen anterior.

Marca un volumen como externo solo cuando su ciclo de vida se gestione intencionadamente fuera de la pila. Compose debería indicar claramente un error si falta un volumen externo, en lugar de crear uno de reemplazo en silencio.

Comprueba si una limpieza eliminó el volumen original

Revisa los registros de despliegue, los scripts, las acciones de la interfaz, los trabajos de limpieza y los comandos que eliminan volúmenes. Compara la hora de creación del volumen con el evento de nuevo despliegue.

Red Hat documenta que los volúmenes con nombre gestionados por contenedores tienen ubicaciones de almacenamiento independientes de las capas de escritura de los contenedores, por lo que eliminar un contenedor y eliminar su volumen con nombre son eventos distintos del ciclo de vida.

Si el volumen original no está, detén los inicios automáticos y restaura solo desde una copia de seguridad verificada. No supongas que un volumen de reemplazo vacío contiene una capa eliminada recuperable.

Compara la identidad asignada por el administrador de pilas y el método de despliegue

Registra si la pila se inició mediante la CLI, Portainer, una tienda de aplicaciones de NAS, un despliegue de Git u otra herramienta de automatización. Compara el nombre de la pila y los valores de entorno almacenados por ese administrador.

Portainer requiere un nombre descriptivo para la pila al desplegarla, y esa identidad controlada por el administrador puede diferir del nombre de proyecto basado en el directorio que usa un comando manual de Compose.

Por lo tanto, un inicio de emergencia manual puede crear recursos con el prefijo de otro proyecto. Elige un único responsable del despliegue y documenta los nombres de volumen que genera.

Descarta que haya datos ocultos bajo el nuevo montaje del volumen

Detén el contenedor e inspecciona la imagen o la ruta enlazada sin el volumen con nombre conectado, usando una prueba desechable. Determina si el inicio escribió datos en la capa del contenedor antes de montar el volumen.

El manual de montaje de Linux explica que un montaje oculta el contenido preexistente de un directorio, por lo que los datos pueden parecer desaparecidos cuando un volumen nuevo y vacío cubre archivos creados en la imagen o en la capa de escritura.

No combines a ciegas la capa oculta con el volumen persistente antiguo. Identifica qué estado es el válido y usa el método de recuperación compatible con la aplicación.

Vuelve a conectar el volumen original con una prueba controlada

Detén la pila, haz una copia de seguridad de ambos volúmenes candidatos, conecta el original a un contenedor desechable o a la ruta de un servicio temporal y verifica los archivos de la aplicación, la identidad de la base de datos, la propiedad y las marcas de tiempo.

La guía de ZimaSpace sobre cómo mover los datos de los contenedores sin interrumpir los montajes ofrece el flujo de trabajo complementario para asignar rutas; este artículo se centra en la identidad de los volúmenes con nombre y alcance de proyecto.

El problema se resuelve cuando el volumen antiguo previsto se monta con un nombre explícito estable o como externo, y las implementaciones repetidas lo reutilizan sin crear otro volumen vacío.

Preguntas frecuentes

¿Que un volumen con nombre esté vacío significa que se borraron los datos antiguos?

No necesariamente. El volumen antiguo puede seguir existiendo con otro prefijo de proyecto o un nombre explícito, mientras que el contenedor nuevo usa un volumen vacío diferente.

¿Cambiar el nombre de la carpeta de Compose puede crear un volumen nuevo?

Sí. Si no se fija un nombre de proyecto, Compose puede deducirlo del directorio del proyecto y crear recursos con prefijos distintos.

¿Se deben marcar como externos los volúmenes importantes?

Los volúmenes externos pueden impedir que la eliminación de la pila gestione su ciclo de vida, pero requieren una creación, asignación de nombres, copia de seguridad y comprobaciones de implementación deliberadas.

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.