Instrucción VOLUME Dockerfile

instruccion-volume-dockerfile
instruccion-volume-dockerfile

En esta lección aprenderás instrucción VOLUME Dockerfile, una instrucción que declara un punto de montaje destinado a datos persistentes o intercambiables entre contenedor y almacenamiento externo.

VOLUME no es lo mismo que copiar archivos ni garantiza por sí solo una estrategia de backup. Sirve para declarar intención, pero la gestión real del volumen depende de cómo ejecutes el contenedor.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Qué hace la instrucción VOLUME Dockerfile

Problema: algunas rutas de una aplicación no deberían quedarse como datos efímeros dentro de la capa writable del contenedor.

Qué aporta Docker: VOLUME marca una ruta como punto de montaje. Si no indicas un volumen al ejecutar, Docker puede crear un volumen anónimo para esa ruta.

SituaciónQué conviene recordar
VOLUME /dataDeclara /data como punto de montaje.
docker run -v datos:/dataUsa un volumen nombrado y controlable.
Volumen anónimoPuede quedar creado aunque no recuerdes su nombre.

Qué declara y qué no declara VOLUME

La sintaxis puede declarar una ruta o varias dentro del contenedor, por ejemplo VOLUME /data o VOLUME [«/data», «/var/log/app»]. No admite el nombre del volumen ni una ruta del host: esos detalles se eligen al crear el contenedor.

ConfiguraciónQué defineQuién la decide
VOLUME /dataMarca /data como punto de montaje de la imagen.El Dockerfile.
–mount type=volume,src=datos-demo,dst=/dataMonta un volumen nombrado que Docker administra.La persona que ejecuta el contenedor.
–mount type=bind,src=/ruta/en/host,dst=/dataMonta una ruta existente del host.La persona que ejecuta el contenedor.

Por tanto, VOLUME no publica una carpeta del host ni crea una política de copias de seguridad. Solo declara el punto de montaje que la imagen espera; el almacenamiento concreto debe configurarse al arrancar.

Ejemplo práctico

FROM alpine:3.20
RUN mkdir -p /data
VOLUME ["/data"]
CMD ["sh", "-c", "date >> /data/fechas.log && cat /data/fechas.log"]
docker build -t volume-demo:1.0 .
docker volume create datos-demo
docker run --rm -v datos-demo:/data volume-demo:1.0
docker volume inspect datos-demo

El Dockerfile declara /data como ruta de datos. El comando docker run usa un volumen nombrado para que sepas qué volumen estás utilizando y puedas inspeccionarlo después.

Qué sucede al ejecutar el contenedor

Si se ejecuta una imagen con una ruta VOLUME sin asignarle un montaje explícito, Docker crea un volumen anónimo con un identificador aleatorio. Ese volumen puede sobrevivir a la eliminación normal del contenedor y no se comparte automáticamente con el siguiente. Con docker run –rm, Docker elimina el volumen anónimo asociado cuando termina el contenedor; un volumen nombrado, como datos-demo en el ejemplo, permanece.

Al montar un volumen vacío sobre una ruta que ya contiene archivos en la imagen, Docker copia esos archivos al volumen de forma predeterminada y el contenido del montaje oculta la ruta original mientras está activo. Si no quieres esa copia inicial, la opción volume-nocopy la desactiva. Revisa también propietario y permisos: el usuario del proceso debe poder acceder a la ruta montada.

Durante la construcción, evita colocar VOLUME antes de instrucciones que deban modificar esa ruta. La referencia de Docker especifica que el builder clásico descarta esos cambios posteriores, mientras que BuildKit los conserva. Preparar primero los archivos y permisos reduce sorpresas y hace más fácil interpretar el resultado.

Errores comunes

  • Creer que VOLUME hace backup: solo declara un punto de montaje; la copia de seguridad es responsabilidad tuya.
  • Depender de volúmenes anónimos: pueden acumularse y ser difíciles de identificar.
  • Escribir datos importantes sin nombrar el volumen: complica mantenimiento, migración y limpieza.
  • Confundir VOLUME con COPY: COPY mete archivos en la imagen; VOLUME declara una ruta de datos.

Advertencia: el resultado de escribir en una ruta después de declarar VOLUME cambia entre el builder clásico y BuildKit. Prepara los archivos antes de esa instrucción y verifica el builder que utiliza tu entorno.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

La instrucción VOLUME Dockerfile queda bien usada cuando comunica claramente qué rutas contienen datos y evitas depender de volúmenes anónimos sin control.

Para producción, acompaña VOLUME con una estrategia explícita de volúmenes nombrados, backups y limpieza segura.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *