#Cómo instalar

La versión actual utiliza la forma de copia de seguridad y restauración para el despliegue. En versiones posteriores, es posible que cambiemos a la forma de migración incremental para facilitar la integración de la solución en sus sistemas existentes.

Para que pueda desplegar la solución de tickets en su propio entorno de NocoBase de forma rápida y fluida, ofrecemos dos métodos de restauración. Elija el que mejor se adapte a su versión de usuario y conocimientos técnicos.

Antes de comenzar, asegúrese de que:

• Usted ya tiene un entorno de ejecución básico de NocoBase. Para la instalación del sistema principal, consulte la documentación oficial de instalación más detallada.
• La versión de NocoBase sea 2.0.0-beta.5 y superior.
• Usted ya ha descargado los archivos correspondientes del sistema de tickets:
  • Archivo de copia de seguridad: nocobase_tts_v2_backup_260302.nbdata - Aplicable al método uno
  • Archivo SQL: nocobase_tts_v2_sql_260302.zip - Aplicable al método dos

Nota importante:

• Esta solución se basa en la base de datos PostgreSQL 16, asegúrese de que su entorno utilice PostgreSQL 16.
• DB_UNDERSCORED no puede ser true: Verifique su archivo docker-compose.yml y asegúrese de que la variable de entorno DB_UNDERSCORED no esté establecida en true; de lo contrario, entrará en conflicto con la copia de seguridad de la solución y la restauración fallará.

#Método uno: Restaurar usando el administrador de copias de seguridad (Recomendado para usuarios de la versión Pro/Enterprise)

Este método se realiza a través del plugin integrado de NocoBase "Administrador de copias de seguridad" (versión Pro/Enterprise) para una restauración con un solo clic, siendo la operación más sencilla. Sin embargo, tiene ciertos requisitos de entorno y versión de usuario.

#Características principales

• Ventajas:
  1. Operación conveniente: Se puede completar en la interfaz de usuario, permitiendo restaurar completamente todas las configuraciones, incluidos los plugins.
  2. Restauración completa: Capaz de restaurar todos los archivos del sistema, incluidos los archivos de impresión de plantillas, archivos subidos en campos de archivo de las tablas, etc., asegurando la integridad de las funciones.
• Limitaciones:
  1. Limitado a Pro/Enterprise: El "Administrador de copias de seguridad" es un plugin de nivel empresarial, disponible solo para usuarios de la versión Pro/Enterprise.
  2. Requisitos de entorno estrictos: Requiere que su entorno de base de datos (versión, configuración de sensibilidad a mayúsculas y minúsculas, etc.) sea altamente compatible con el entorno donde creamos la copia de seguridad.
  3. Dependencia de plugins: Si la solución incluye plugins comerciales que no tiene en su entorno local, la restauración fallará.

#Pasos a seguir

Paso 1: [Altamente recomendado] Inicie la aplicación usando la imagen full

Para evitar fallos en la restauración debido a la falta de clientes de base de datos, le recomendamos encarecidamente utilizar la versión full de la imagen de Docker. Esta incluye todos los programas de soporte necesarios, eliminando la necesidad de configuraciones adicionales.

Ejemplo de comando para descargar la imagen:

docker pull nocobase/nocobase:beta-full

Luego, use esta imagen para iniciar su servicio de NocoBase.

Nota: Si no utiliza la imagen full, es posible que deba instalar manualmente el cliente de base de datos pg_dump dentro del contenedor, un proceso tedioso e inestable.

Paso 2: Active el plugin "Administrador de copias de seguridad"

1. Inicie sesión en su sistema NocoBase.
2. Vaya a Gestión de plugins.
3. Busque y active el plugin Administrador de copias de seguridad.

Paso 3: Restaurar desde un archivo de copia de seguridad local

1. Tras activar el plugin, actualice la página.
2. Vaya al menú de la izquierda Gestión del sistema -> Administrador de copias de seguridad.
3. Haga clic en el botón Restaurar desde copia de seguridad local en la esquina superior derecha.
4. Arrastre el archivo de copia de seguridad descargado al área de carga.
5. Haga clic en Enviar y espere pacientemente a que el sistema complete la restauración; este proceso puede tardar desde unos segundos hasta varios minutos.

#Notas

• Compatibilidad de la base de datos: Este es el punto más crítico de este método. La versión, el conjunto de caracteres y la configuración de sensibilidad a mayúsculas y minúsculas de su base de datos PostgreSQL deben coincidir con el archivo fuente de la copia de seguridad. En particular, el nombre del schema debe ser consistente.
• Coincidencia de plugins comerciales: Asegúrese de tener y haber activado todos los plugins comerciales requeridos por la solución; de lo contrario, la restauración se interrumpirá.

#Método dos: Importar directamente el archivo SQL (Universal, más adecuado para la versión Community)

Este método restaura los datos operando directamente en la base de datos, omitiendo el plugin "Administrador de copias de seguridad", por lo que no tiene las restricciones de los plugins de la versión Pro/Enterprise.

#Características principales

• Ventajas:
  1. Sin restricciones de versión: Aplicable a todos los usuarios de NocoBase, incluida la versión Community.
  2. Alta compatibilidad: No depende de la herramienta dump dentro de la aplicación; funciona siempre que pueda conectarse a la base de datos.
  3. Alta tolerancia a fallos: Si la solución contiene plugins comerciales que usted no tiene, las funciones relacionadas no se activarán, pero esto no afectará el uso normal de otras funciones y la aplicación podrá iniciarse con éxito.
• Limitaciones:
  1. Requiere capacidad de operación de base de datos: Requiere que el usuario tenga conocimientos básicos de operación de bases de datos, como por ejemplo cómo ejecutar un archivo .sql.
  2. Pérdida de archivos del sistema: Este método perderá todos los archivos del sistema, incluidos los archivos de impresión de plantillas, archivos subidos en campos de archivo de las tablas, etc.

#Pasos a seguir

Paso 1: Preparar una base de datos limpia

Prepare una base de datos completamente nueva y vacía para los datos que va a importar.

Paso 2: Importar el archivo .sql a la base de datos

Obtenga el archivo de base de datos descargado (generalmente en formato .sql) e importe su contenido en la base de datos que preparó en el paso anterior. Hay varias formas de hacerlo, dependiendo de su entorno:

• Opción A: A través de la línea de comandos del servidor (ejemplo con Docker) Si utiliza Docker para instalar NocoBase y la base de datos, puede subir el archivo .sql al servidor y luego usar el comando docker exec para realizar la importación. Suponiendo que su contenedor de PostgreSQL se llama my-nocobase-db y el nombre del archivo es ticket_system.sql:

  # Copiar el archivo sql al interior del contenedor
  docker cp ticket_system.sql my-nocobase-db:/tmp/
  # Entrar al contenedor y ejecutar la instrucción de importación
  docker exec -it my-nocobase-db psql -U su_nombre_usuario -d su_nombre_base_datos -f /tmp/ticket_system.sql

• Opción B: A través de un cliente de base de datos remoto Si su base de datos tiene el puerto expuesto, puede usar cualquier cliente gráfico de base de datos (como DBeaver, Navicat, pgAdmin, etc.) para conectarse a la base de datos, abrir una nueva ventana de consulta, pegar todo el contenido del archivo .sql y ejecutarlo.

Paso 3: Conectar la base de datos e iniciar la aplicación

Configure los parámetros de inicio de su NocoBase (como las variables de entorno DB_HOST, DB_PORT, DB_DATABASE, DB_USER, DB_PASSWORD, etc.) para que apunten a la base de datos donde acaba de importar los datos. Luego, inicie el servicio de NocoBase normalmente.

#Notas

• Permisos de base de datos: Este método requiere que usted tenga una cuenta y contraseña con permisos para operar directamente la base de datos.
• Estado de los plugins: Tras una importación exitosa, aunque los datos de los plugins comerciales existan en el sistema, si no tiene instalados y activados los plugins correspondientes localmente, las funciones relacionadas no se mostrarán ni se podrán usar, pero esto no causará que la aplicación falle.

#Resumen y comparación

Esperamos que este tutorial le ayude a desplegar con éxito el sistema de tickets. Si encuentra algún problema durante el proceso, ¡no dude en ponerse en contacto con nosotros!