La respuesta corta

En Pro, un volumen persistente es un path absoluto de mount en un servicio. La app tiene que escribir ahí. Redesplegá una vez y volvé a leer un registro de prueba. Así confirmás que los datos sobreviven al redesplegar.

El filesystem del contenedor no es ese path. Un deploy, un reinicio o un reschedule puede reemplazar el contenedor, y los archivos que solo vivían ahí se van con él. Un backup a un destino compatible con S3 que controlás es una tercera cosa: una copia, no el disco en uso.

Un volumen no es un backup. Redesplegar no restaura datos.

La página de producto es archivos persistentes. La referencia es Persistent storage and backups. La guía es Configure persistent storage and backups, y el armado de la app está en Deploy an application with persistent files.

Filesystem del contenedor y volumen persistente

Los contenedores de la app son reemplazables. Tratá como temporales los archivos que solo se escriben en el filesystem del contenedor.

Filesystem del contenedorVolumen persistente
DuraciónTemporal. Un deploy, un reinicio o un reschedule puede reemplazar el contenedor.Un path duradero para un servicio, si la app escribe en el mount.
AlcanceEse contenedor.Un servicio, un path absoluto dentro del contenedor.
RéplicasNo es un disco compartido.Un servicio con volumen corre una réplica.
RecuperaciónUn redespliegue no devuelve esos archivos.No es un backup. Reset, Detach y borrar el servicio eliminan los datos.

En Free, una app inactiva se duerme, y la memoria y los archivos temporales se descartan cuando se duerme. Free no incluye volúmenes persistentes. Las dos cosas están en precios.

Que falte un archivo después de un redespliegue no es la misma falla que un crash. Si el deployment se frenó, leé la etapa en Depurar un deploy fallido. Un rollback de la app promueve un deployment anterior. No restaura una base, un volumen ni un efecto externo.

Elegí qué va en el volumen

Dejá las dependencias instaladas y el código compilado en la imagen. Poné uploads o datos de la app bajo un path dedicado, como /data.

No montes encima del directorio de la app. Un mount puede tapar archivos que venían en la imagen.

Si varios servicios o varias réplicas necesitan los mismos archivos, usá object storage externo o una base. Un volumen de Unbroker está adjunto a un servicio, y un servicio con volumen corre una réplica. No es un filesystem compartido. El mismo corte es el que ordena los volúmenes de un Compose en Docker Compose en producción.

En un template de base, dejá el volumen montado en el directorio de datos que espera el motor. Mover el mount sin mover y validar los datos puede hacer que el motor parezca vacío aunque los archivos estén en otro lado.

Hacé configurable el path de los datos

Apuntá el proceso al mount con una variable de entorno. La guía de archivos persistentes usa DATA_DIR en una ilustración de Node.js:

const directory = process.env.DATA_DIR;
if (!directory) throw new Error("DATA_DIR is required");

El resto de esa ilustración crea el directorio, escribe settings.json pasando por un archivo temporal y lo renombra a su lugar. Es un archivo de settings de un solo escritor, no una base concurrente. Serializá las escrituras en la app. El nombre fijo del temporal no sirve para escritores simultáneos. El snippet completo está en Deploy an application with persistent files.

Para registros que necesitan transacciones o updates concurrentes, usá PostgreSQL u otra base. Esa elección es la última sección de esta nota.

Un servicio Node arranca en Desplegar Node.js. Un contenedor arranca en Desplegar Docker.

Montá, desplegá y verificá

La guía usa el mount /data y DATA_DIR=/data. Confirmá que el usuario de runtime puede leer y escribir ese directorio.

Los comandos de volumen documentados son:

ubctl apps volumes ls
ubctl apps volumes attach svc_123 --path /app/data --size 10
ubctl apps volumes resize svc_123 --size 20

svc_123, /app/data, 10 y 20 son los ejemplos de la CLI de volúmenes. Usá el path absoluto donde escribe la app. El /data de la guía y el /app/data de la CLI son dos ejemplos de ese path, no dos mounts. Los volúmenes pueden crecer y no pueden achicarse. Reset y detach no están en esta CLI. Esas acciones están en Storage, en la configuración del servicio.

Después demostrá el mount:

  1. Desplegá y creá un registro de prueba inofensivo desde la app. Anotá el valor.
  2. Redesplegá el mismo servicio y volvé a leer el registro.
  3. Confirmá que el código nuevo se ve y que el dato de prueba sigue ahí.

Eso agarra una app que todavía escribe en un directorio relativo, fuera del mount. Probá también la app cuando el filesystem está casi lleno, o cuando una escritura falla.

Un comando post-deploy corre en una copia aparte de la imagen nueva y no monta el volumen persistente, así que no puede cargar datos en ese disco. Ese límite está en la CLI de deployments.

Acciones del volumen y su costo

Abrí la pestaña Settings del servicio. La sección Storage lista el volumen. Cada acción aplica en el acto. Ninguna espera al próximo deploy. El costo de esta sección son los datos. La factura es la sección que sigue.

AcciónEfecto
GrowSube el tamaño, hasta 50 GB. El volumen crece online y no reinicia el servicio. La facturación de storage pasa al tamaño nuevo en el acto. No se puede achicar.
Reset dataBorra todo lo que hay en el volumen y reinicia el servicio sobre uno vacío. El volumen conserva el tamaño y el path de mount. Una base reinicia recién inicializada, con sus credenciales actuales.
Detach volumeBorra el volumen y sus datos, y deja el servicio. El servicio se detiene y después redespliega su imagen actual sin storage persistente. Los backups programados de ese servicio se apagan.
Borrar el servicioBorra el volumen adjunto y sus datos.

Las bases necesitan su volumen, así que ofrecen Reset data y no Detach.

Reset y Detach no se pueden deshacer. Los dos piden que escribas el nombre del servicio. Los dos esperan a que termine cualquier deployment, backup o restore en curso. No los uses para diagnosticar un problema de arranque si no tenés un plan de recuperación. El comportamiento actual está en Persistent storage and backups.

Los backups son otro sistema

Cloud Apps puede mandar backups del volumen a un destino compatible con S3 que controlás. Una programación define cuándo corren y cuántos se retienen. Un restore pide el nombre del servicio antes de correr. El volumen sigue sin ser un backup.

La CLI de storage documenta este ejemplo. Reemplazá los valores de ejemplo. Dejá las credenciales del destino fuera del repositorio.

export UBCTL_S3_ACCESS_KEY="..."
export UBCTL_S3_SECRET_KEY="..."
ubctl apps backups destinations create \
  --name primary \
  --endpoint https://s3.example.com \
  --region us-east-1 \
  --bucket app-backups \
  --prefix unbroker
ubctl apps backups destinations ls
ubctl apps backups schedule svc_123 --destination dst_123 --cron "0 3 * * *" --retain 7
ubctl apps backups run svc_123
ubctl apps backups ls svc_123
ubctl apps backups restore svc_123 backup_123 --confirm orders-db

0 3 * * *, --retain 7 y --confirm orders-db son ese ejemplo, no una programación por defecto ni un nombre por defecto. --confirm es el nombre del servicio.

Confirmá que un backup programado termina y que el destino tiene los archivos de recuperación que esperás. En una base, seguí los requisitos de backup del motor y probá la base restaurada, no solo que los archivos existan. Cuando puedas, ensayá el restore en un destino aislado: registros, permisos y el arranque de la app. Un health check en verde no te dice el punto de recuperación ni cuánto tarda un restore. Anotá los dos.

Los cargos del destino quedan fuera de la tarifa de volumen de Unbroker. Contá el volumen aprovisionado y esos cargos antes de que el disco se llene. Un armado que deja la carpeta de usuario en un volumen y Postgres al lado está en Self-host de n8n.

Notas de facturación

Los volúmenes persistentes requieren Pro. La tabla de planes los lista como no disponibles en Free y disponibles en Pro. Pro sale $25 por mes, con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no se acumula. Si el uso elegible queda por debajo del crédito, el cargo mensual sigue siendo el precio del plan. Las cifras actuales están en precios y en Plans.

El storage se factura por los bytes aprovisionados, no por los bytes que ocupan los archivos. La página de precios lista el storage a $0.2 por GB decimal aprovisionado al mes. La documentación de billing escribe esa tarifa como $0.20 por GB decimal aprovisionado, en un mes de 720 horas. Los tamaños de la plataforma suelen expresarse en GiB binarios, así que un volumen de 10 GiB equivale a 10.73741824 GB decimales y cuesta aproximadamente $2.15 por 720 horas a esa tarifa. La página de precios muestra el mismo ejemplo como 10.74 GB decimales y alrededor de $2.15 por un mes de 720 horas. Los intervalos parciales se prorratean. La tarifa, la cifra sin redondear de 10 GiB y ese prorrateo están en Billing and usage.

El tamaño del volumen cuenta aunque la app guarde pocos datos. Puede crecer y no puede achicarse, así que elegí el primer tamaño y el plan de crecimiento contra el comportamiento del storage y precios. Agrandar el volumen pasa la facturación de storage al tamaño nuevo en el acto.

Cuándo usar una base gestionada

Un volumen sirve para archivos de un solo escritor en un servicio. No sirve para updates concurrentes, transacciones, o varios servicios leyendo y escribiendo los mismos registros.

Para eso usá PostgreSQL u otra base. En Unbroker las dos formas son distintas. Un clúster gestionado de Postgres o MySQL lo opera el proveedor y requiere Pro. Un nodo de base en Apps es una imagen de base y un volumen persistente que operás vos, incluida la recuperación de ese volumen. Las bases gestionadas no están en Free. La lista de planes está en Postgres gestionado. Cómo operar el servidor que elegiste está en Postgres en producción.

Checklist

  1. En Pro, decidí qué archivos tienen que sobrevivir a un contenedor nuevo. Dejá el código y las dependencias en la imagen.
  2. Elegí un path absoluto, como /data. No lo montes encima del directorio de la app.
  3. Apuntá la app a ese path. En la ilustración de Node, seteá DATA_DIR y escribí solo debajo.
  4. Adjuntá el volumen en ese path. Confirmá que el usuario de runtime puede escribir ahí.
  5. Creá un registro de prueba, redesplegá y volvé a leerlo. Confirmá que el código nuevo está live y que el registro quedó.
  6. Dejá el tamaño en un punto desde el que puedas crecer. No podés achicar. El tope es 50 GB.
  7. Tratá Reset, Detach y borrar el servicio como borrar los datos. Las bases ofrecen Reset, no Detach.
  8. Mandá los backups a un destino compatible con S3 que controlás. Restaurá una vez en un destino aislado antes de poner ahí datos que no podés recrear.
  9. Si más de un servicio o una réplica tiene que compartir los datos, usá una base u object storage externo en lugar de este volumen.

Preguntas frecuentes

¿Por qué desaparecen mis archivos después de un redespliegue?

Estaban en el filesystem del contenedor. Los contenedores de la app son reemplazables, y un deploy, un reinicio o un reschedule puede reemplazar ese contenedor. Los archivos que solo se escribieron ahí se tratan como temporales. Un volumen persistente es otro path. Si la app nunca escribió en el mount, el volumen puede quedar vacío cuando el contenedor viejo ya no está. Eso está en Persistent storage and backups.

¿Un volumen persistente sobrevive a un redespliegue?

Sí, si la app escribe en el path absoluto montado. Creá un registro de prueba, redesplegá y volvé a leerlo. El código nuevo puede estar live y el registro seguir ahí. Un redespliegue no restaura archivos que nunca estuvieron en el volumen, y no deshace Reset, Detach ni borrar el servicio.

¿Un volumen es un backup?

No. Un volumen es el disco en uso de un servicio. Un backup es una copia aparte en un destino compatible con S3 que controlás. La página de storage dice que un volumen persistente no es, por sí mismo, un backup, y que configures y pruebes los backups antes de poner ahí datos que no podés recrear.

¿Puedo achicar un volumen?

No. Un volumen puede crecer, hasta 50 GB, y no puede achicarse. Grow corre online, sin reiniciar el servicio, y la facturación de storage pasa al tamaño nuevo en el acto. Elegí el primer tamaño con ese límite a la vista.

¿Los servicios con volumen soportan varias réplicas?

No. Un volumen pertenece a un servicio, y un servicio con volumen corre una réplica. No es un filesystem compartido para varias réplicas o varios servicios. Si más de un escritor necesita los mismos datos, usá una base o object storage externo.

¿Free incluye volúmenes persistentes?

No. La tabla de planes lista los volúmenes persistentes como no disponibles en Free y disponibles en Pro. Pro sale $25 por mes, con $25 de crédito de uso. Mirá precios y Plans.

¿Qué pasa si borro el servicio?

Borrar el servicio borra el volumen adjunto y sus datos. Reset y Detach también borran los datos del volumen. Ninguno de los dos se puede deshacer. Los dos piden que escribas el nombre del servicio, y los dos esperan a que termine cualquier deployment, backup o restore en curso.

¿Cuánto cuesta el storage?

La página de precios lista el storage a $0.2 por GB decimal aprovisionado al mes, según el tamaño que aprovisionás, no según lo lleno que esté el disco. La documentación de billing escribe esa tarifa como $0.20 por GB decimal aprovisionado, en un mes de 720 horas. Un volumen de 10 GiB equivale a 10.73741824 GB decimales y cuesta aproximadamente $2.15 por 720 horas. La página de precios muestra ese ejemplo como 10.74 GB decimales y alrededor de $2.15. Los intervalos parciales se prorratean.