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ón | Qué conviene recordar |
|---|---|
| VOLUME /data | Declara /data como punto de montaje. |
| docker run -v datos:/data | Usa un volumen nombrado y controlable. |
| Volumen anónimo | Puede 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ón | Qué define | Quién la decide |
|---|---|---|
| VOLUME /data | Marca /data como punto de montaje de la imagen. | El Dockerfile. |
| –mount type=volume,src=datos-demo,dst=/data | Monta un volumen nombrado que Docker administra. | La persona que ejecuta el contenedor. |
| –mount type=bind,src=/ruta/en/host,dst=/data | Monta 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-demoEl 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
- Instrucción COPY
- Instrucción WORKDIR Dockerfile
- Cómo crear volúmenes Docker
- Cómo montar volúmenes en Docker
- Cómo limpiar volúmenes de forma segura
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.

