Almacenamiento persistente
Cuándo usar persistencia
- Activa Has Persistent Data para bases de datos y aplicaciones que almacenan archivos subidos localmente.
- Solo se conservan las rutas montadas que hayas configurado. Activar la opción de persistencia no guarda automáticamente cualquier archivo del contenedor.
- Las aplicaciones web stateless pueden utilizar bases de datos o almacenamiento de objetos externos.
Volúmenes Docker
- Configura el nombre del volumen y la ruta del contenedor donde escribe la aplicación.
- PostgreSQL suele utilizar
/var/lib/postgresql/data; verifica la ruta de tu imagen. - Las versiones recientes de CapRover utilizan el nombre de volumen indicado. Los volúmenes antiguos (anteriores a 1.15) pueden tener el prefijo
captain--; compruébalo condocker volume ls.
Para inspeccionar un volumen huérfano después de eliminar una aplicación:
docker volume ls
docker volume inspect VOLUME_NAME
docker ps -a --filter volume=VOLUME_NAME
Elimina el volumen con docker volume rm VOLUME_NAME únicamente después de confirmar a qué pertenecía, que ya no se utiliza y que tienes un backup. Evita usar docker volume prune indiscriminadamente en hosts compartidos.
Bind mounts
- Mapea una ruta absoluta del host a la ruta del contenedor, por ejemplo
/srv/app/uploads→/app/uploads. - Crea el directorio del host y configura los permisos para el usuario del contenedor.
- Evita montar directorios sensibles del host en contenedores no confiables.
Directorios persistentes
- Configura los montajes en Persistent Directories de la aplicación.
- Comprueba que la aplicación escribe en la ruta del contenedor que has montado.
- Haz backups de esos datos por separado del backup de configuración de CapRover.
Asignación de nodos
- Los volúmenes con nombre y bind mounts suelen ser locales a un nodo.
- CapRover fija las aplicaciones persistentes al nodo que almacena sus datos. La misma ruta en nodos distintos no implica que se comparta el contenido.
- Para mover una aplicación persistente: detén las escrituras, haz un backup, migra los datos, verifica los permisos, cambia el nodo asignado y comprueba los datos restaurados.
Prueba de persistencia
Escribe un archivo de prueba en la ruta montada, vuelve a desplegar la aplicación y comprueba que el archivo sigue allí. Para bases de datos, utiliza un export o backup compatible con el motor.
Para almacenamiento compartido, consulta Almacenamiento compartido. Para copias y migraciones, consulta Backup de datos persistentes.