Inicia una base de datos en un contenedor, agrega algunos datos, elimina el contenedor y comienza uno nuevo. Los datos se han ido. Casi todo el mundo aprende esta lección por las malas. Los volúmenes Docker y los montajes de enlace existen para mantener los datos vivos más allá de la vida útil de cualquier contenedor.

Esta guía explica cómo funciona cada uno y cómo elegir. Los comandos y archivos aquí son ejemplos estándar, basados ​​en el comportamiento documentado de Docker, y no los ejecutamos para este artículo, así que pruébelos primero con datos desechables. Los detalles pueden diferir entre las versiones de Docker y en Docker Desktop. Si eres nuevo en el mundo de los contenedores, comienza con nuestro tutorial de Docker para principiantes.

Por qué desaparecen los datos del contenedor

Una imagen de Docker está formada por capas de solo lectura. Cuando se inicia un contenedor, Docker agrega una fina capa grabable en la parte superior y cualquier cambio va allí. Esa capa sobrevive a una parada y reinicio, pero se elimina cuando se elimina el contenedor.

docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# ... create tables and add data ...
docker rm -f db
docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# The data you added is not there

Esto es por diseño, ya que le permite reemplazar contenedores libremente. Lo que sí significa es que todo lo que necesites conservar debe vivir fuera del contenedor. Hay tres maneras de hacerlo:

Volúmenes de Docker frente a montajes de enlace uno al lado del otro

Volúmenes nombrados

Un volumen es un almacenamiento creado y administrado por Docker. Te refieres a él por su nombre y no es necesario que te importe dónde vive físicamente.

docker volume create pgdata

docker run -d --name db \
  -e POSTGRES_PASSWORD=devonly \
  -v pgdata:/var/lib/postgresql/data \
  postgres:17

Ahora los archivos de la base de datos se encuentran en pgdata. Elimine el contenedor y comience uno nuevo con el mismo volumen, y sus datos seguirán ahí. En Linux, los volúmenes normalmente se encuentran en /var/lib/docker/volumes/, pero no debes editar esos archivos directamente. En Docker Desktop, viven dentro de una máquina virtual, no en una carpeta normal.

La ruta dentro del contenedor depende de la imagen, así que consulte la documentación de la imagen. Montar en la ruta incorrecta es un error clásico: todo parece funcionar, pero los datos aún se escriben en la capa contenedora. Las versiones principales más recientes de una imagen también pueden cambiar esta ruta, así que lea las notas de la versión antes de actualizar.

Docker creará un volumen con nombre automáticamente si no existe. Un volumen anónimo, creado sin nombre, también funciona, pero obtiene una identificación aleatoria larga y es fácil perderle la pista. Siempre dé nombres a sus volúmenes.

Enlazar monturas

Un montaje de enlace asigna una ruta de host específica directamente al contenedor. Ambas partes ven los mismos archivos inmediatamente. Esto lo hace perfecto para el desarrollo, ya que las ediciones en su editor surten efecto en el contenedor en ejecución sin una reconstrucción:

docker run -d --name web \
  -p 8080:80 \
  -v "$(pwd)/site:/usr/share/nginx/html:ro" \
  nginx:1.27

Edite un archivo en site/, actualice el navegador y verá el cambio. El :ro hace que el montaje sea de solo lectura dentro del contenedor, lo cual es un buen hábito cuando el contenedor no necesita escribir allí.

Las monturas vinculantes tienen algunas desventajas:

• Te vinculan al host. La ruta debe existir en cada máquina, por lo que las configuraciones son menos portátiles.
• Ocultan el contenido de la imagen. Si montas sobre /app, todo lo que la imagen tenía allí se vuelve invisible. Un ejemplo común es la desaparición de node_modules.
• Exponen el host. Un contenedor con un montaje grabable puede cambiar o eliminar archivos de host reales. Nunca monte rutas sensibles como / o el socket Docker a menos que comprenda completamente el riesgo.
• El rendimiento puede variar. En Docker Desktop para macOS y Windows, el uso compartido de archivos cruza los límites de la virtualización y puede ser más lento que en Linux.

montajes tmpfs

Un montaje tmpfs vive en la memoria del host y nunca se escribe en la capa contenedora. Desaparece cuando el contenedor se detiene, por lo que se adapta a archivos temporales, cachés y datos confidenciales de corta duración:

docker run -d --tmpfs /app/cache:size=64m myapp:1.0

tmpfs está disponible en hosts Linux. También puede acelerar las bases de datos en entornos de prueba desechables, donde no le importa conservar los datos.

-v o –mount?

Ambas banderas funcionan. --mount es más largo, pero más explícito y mucha gente lo prefiere en guiones:

# Short form
docker run -v pgdata:/var/lib/postgresql/data postgres:17

# Explicit form
docker run --mount type=volume,source=pgdata,target=/var/lib/postgresql/data postgres:17

# Bind mount, read-only
docker run --mount type=bind,source="$(pwd)"/site,target=/usr/share/nginx/html,readonly nginx:1.27

Hay una diferencia significativa. Con -v, se crea una ruta de host faltante como una carpeta vacía, lo que puede ocultar un error tipográfico. Con --mount y un tipo de enlace, Docker informa un error. Además, con -v, el lado izquierdo decide el tipo: un nombre significa un volumen y una ruta significa un montaje de enlace. Entonces -v data:/x y -v ./data:/x hacen cosas muy diferentes.

Volúmenes en Docker Compose

La mayoría de los proyectos reales declaran el almacenamiento en un archivo Compose. Éste utiliza ambos tipos, cada uno para su función adecuada:

services:
  web:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - ./src:/app/src      # bind mount: live code
    depends_on:
      - db

  db:
    image: postgres:17
    environment:
      POSTGRES_PASSWORD: devonly
    volumes:
      - pgdata:/var/lib/postgresql/data   # named volume: data

volumes:
  pgdata:

Los volúmenes nombrados deben declararse en la sección de nivel superior volumes. Compose antepone el nombre real al nombre del proyecto. Consulte nuestro tutorial de Docker Compose para obtener un tutorial completo.

Comandos de volumen útiles

Verifique qué eliminará prune antes de confirmarlo, ya que esto no se puede deshacer. Es posible que los volúmenes que ningún contenedor utiliza actualmente aún contengan datos importantes.

Realizar una copia de seguridad y restaurar un volumen

Se puede realizar una copia de seguridad de un volumen ejecutando un contenedor de corta duración que monte tanto el volumen como una carpeta host:

# Back up
docker run --rm \
  -v pgdata:/data:ro \
  -v "$(pwd)":/backup \
  alpine tar czf /backup/pgdata.tar.gz -C /data .

# Restore into a new volume
docker volume create pgdata_restored
docker run --rm \
  -v pgdata_restored:/data \
  -v "$(pwd)":/backup \
  alpine tar xzf /backup/pgdata.tar.gz -C /data

Para una base de datos activa, copiar archivos como este puede capturar un estado inconsistente. Primero detenga el contenedor, o mejor, use la herramienta propia de la base de datos, como pg_dump para PostgreSQL. Y una copia de seguridad que nunca has restaurado es en realidad sólo una esperanza, así que prueba la restauración.

Permisos de archivos

“Permiso denegado” es el problema más común con los soportes. Los archivos mantienen sus ID numéricos de usuario y grupo en Linux, por lo que si un contenedor se ejecuta como usuario 1000 y la carpeta host pertenece a otro usuario, las escrituras fallarán. Algunas formas de solucionar este problema:

• Ejecute el contenedor con un usuario coincidente: docker run --user "$(id -u):$(id -g)" ...
• Configure la propiedad correcta de su imagen, como se describe en nuestras mejores prácticas de Dockerfile.
• Prefiera volúmenes con nombre para los datos, ya que un nuevo volumen adquiere la propiedad de la carpeta de la imagen cuando se utiliza por primera vez.
• En sistemas que utilizan SELinux, los montajes vinculados pueden necesitar una etiqueta :z o :Z.

Evite la tentación de chmod 777, como explica nuestra guía de comandos de Linux.

¿Cuál deberías usar?

Esa última fila importa. En producción, el código pertenece a la imagen, por lo que lo que probaste es lo que ejecutas. En los clústeres, el almacenamiento de datos vuelve a funcionar de manera diferente, a través de volúmenes persistentes, que se tratan en la documentación más amplia de Kubernetes. Nuestra guía Docker vs Kubernetes explica cómo se relacionan ambos.

Errores comunes

• Montaje en la ruta incorrecta. Los datos aún residen en la capa contenedora y desaparecen más adelante.
• Ejecutando down -v casualmente. Esto elimina los volúmenes nombrados.
• Usando rutas relativas con -v. Formularios como -v data:/x crean un volumen en lugar de una asignación de carpetas.
• Colocar secretos en soportes de enlace grabables. Móntelos como de solo lectura o utilice una función de secretos.
• Apuntar dos contenedores de bases de datos a un volumen. Esto puede dañar los datos.
• No tener copias de seguridad. Un volumen no es una copia de seguridad. Vive en el mismo disco.

Conclusión

La regla general es breve: volúmenes con nombre para los datos, montajes vinculados para el código que está editando y tmpfs para las cosas que no deberían durar. Pruébelo en una base de datos desechable. Cree un volumen con nombre, agregue una fila, elimine el contenedor, inicie uno nuevo y confirme que su fila sobrevivió. Luego practique una copia de seguridad y una restauración antes de que la necesite.

Preguntas frecuentes

sigue aprendiendo