Copia de seguridad y restauración
Si ha guardado una aplicación NocoBase como un entorno CLI, la copia de seguridad y la recuperación diarias se completan básicamente en el grupo de comandos nb backup. nb backup create se utiliza para crear una copia de seguridad en el entorno de destino y descargarla en el local. nb backup restore se utiliza para restaurar el archivo de copia de seguridad local en el entorno de destino.
La mayoría de las veces, basta con recordar el consejo predeterminado: hacer una copia de seguridad antes de actualizar, migrar o cambiar datos por lotes; realice la recuperación solo cuando sepa claramente que desea sobrescribir los datos actuales.
Índice rápido
::: consejo primero confirme el entorno actual
El comando nb backup actúa sobre el entorno actual de forma predeterminada. Si mantiene varios entornos al mismo tiempo, la recomendación predeterminada es echar un vistazo al entorno actual antes de realizar una copia de seguridad o una restauración.
Si pasa explícitamente un --env diferente, la CLI normalmente solicitará confirmación. En scripts o escenarios no interactivos, puede agregar --yes para omitir este paso.
:::
Crea una copia de seguridad
El uso más sencillo es crear una copia de seguridad directamente:
Una vez que el comando regresa correctamente, el archivo de copia de seguridad se ha descargado localmente. Cuando se omite --output, la CLI guarda el archivo en el directorio de trabajo actual y utiliza el nombre de archivo devuelto por el extremo remoto, generalmente backup_*.nbdata.
Si desea colocar las copias de seguridad en un directorio, puede usar esto:
Si ./backups ya existe y es un directorio, la CLI agregará automáticamente el nombre del archivo de copia de seguridad remota al directorio. Solo si la ruta no existe, la CLI la tratará como la ruta del archivo de destino.
Si desea seguir consumiendo los resultados de la copia de seguridad en scripts, CI o enlaces de agentes, puede agregar --json-output:
En este modo, la CLI ya no genera texto de progreso, sino que devuelve directamente el JSON final, que normalmente contiene tres campos: env, name y output.
Restaurar copia de seguridad
El comando de restauración cargará el archivo de copia de seguridad local en el entorno de destino y sobrescribirá los datos de la aplicación actual:
Si desea restaurar algo distinto al entorno actual, generalmente es más seguro escribir así:
:::nota de advertencia
La recuperación es una operación de cobertura total. De forma predeterminada, se recomienda realizar otra copia de seguridad del entorno de destino actual antes de restaurar.
:::
nb backup restore primero verificará si la ruta señalada por --file existe y confirmará que es un archivo normal. Después de que la carga sea exitosa, la CLI continuará esperando a que la aplicación pase la verificación de estado nuevamente, de modo que cuando el comando regrese exitosamente, la aplicación generalmente se habrá restaurado a un estado accesible.
Si no se pasa --force, el terminal interactivo le pedirá confirmación nuevamente. En terminales no interactivos, scripts y sesiones de agente de IA, se requiere --force.
Situaciones comunes
Si está más acostumbrado a operar en la interfaz o necesita capacidades como copias de seguridad programadas y sincronización del almacenamiento en la nube, puede ver directamente [Administración de copias de seguridad] (../../ops-management/backup-manager/index.mdx). En tales escenarios, la interfaz de usuario web suele ser más adecuada.
Enlaces relacionados
nb backupReferencia de comandonb envReferencia de comando- [Gestión de entornos múltiples] (./multi-environment.md)
- Gestión de copias de seguridad