Introducción
Algunos usuarios pueden necesitar automatizar el proceso de implementación simplemente ejecutando un archivo .bat o desean realizar cambios en componentes específicos en su entorno de producción sin realizar un proceso de implementación complejo. Bizagi reconoce estas situaciones y ofrece la automatización de la implementación a través de la implementación de la línea de comandos. Esta es una tercera forma de implementar proyectos que solo requieren la edición de archivos de configuración del usuario o la especificación de parámetros.
¿Cuándo usar el Deployment por Línea de Comandos?
El deployment de Procesos se hace una vez que la etapa de automatización haya sido completada y cuando desea publicar su proceso a un ambiente de pruebas o de producción.
El Deployment por Línea de Comandos es útil cuando se quiere automatizar el proceso de deployment corriendo un archivo .bat.
¿Cómo funciona el Deployment por Línea de Comandos?
El Deployment por Línea de Comandos funciona siguiendo los pasos de Exportación e Importación del Deployment Avanzado, permitiendo la ejecución de los mismos por línea de comandos.
Importante
Antes de continuar, asegúrese que tiene presente las siguientes consideraciones.
•El ambiente objetivo debe tener una base de datos del modelo de Bizagi. Por lo tanto, asegúrese de correr CreateDatabase.exe cuando esté realizando el proceso de Deployment por primera vez.
•Los parámetros no deben tener el prefijo de doble guión --.
•Cualquier caracter de barra invertida \ en la configuración debe ser escrito con doble barra \\.
•Cualquier caracter de comillas dobles " que se desee incluir en la línea de comandos debe ser precedido por una barra invertida \".
Perfil requerido
El usuario que va a realizar el proceso de Deployment Avanzado o por Línea de Comandos necesita:
1. Entendimiento básico de la estructura JSON (para configurar los archivos de configuración).
2. Tener acceso a las bases de datos de los ambientes del proyecto (con credenciales de superusuario).
3. Tener experiencia en los conceptos involucrados con el Deployment de un Proyecto en Bizagi.
Para más información en el tratamiento de los objetos en el deployment, refiérase a Deployment de los objetos
4. Entendimiento del Proceso implementado en el proyecto.
Esto significa que se debe conocer el objetivo del proceso, el modelo de datos, versiones, integraciones, configuraciones de seguridad, administración de las configuraciones de ambiente (como políticas, alarmas, valores de las entidades parámetro), y en funcionamiento en general.
Tenga en cuenta que para probar apropiadamente (hacer pruebas de aceptación de usuarios), esto incluirá saber cual es el comportamiento esperado del Proceso en el Portal de Trabajo (bajo los diferentes escenarios de negocio).
Archivos ejecutables del Deployment por Línea de Comandos
El Deployment por Línea de Comandos un archivo ejecutable del Deployment Avanzado, cada uno con sus respectivos parámetros.
Este archivo ejecutable viene instalado por defecto en la carpeta del Management Console (en C:\Program Files\Bizagi\Bizagi Studio\MC\).
Ejecutable |
Propósito |
|---|---|
CreateImport.exe |
Aplica los cambios a su ambiente de producción. Esto se hace después de analizar el archivo .bex de exportación contra el ambiente de producción, y considerando cómo se debe manejar la información existente (unir registros). |
Para obtener ejemplos de cómo construir los archivos .bat que corren los archivos ejecutables de arriba, por favor refiérase a Exportar templates de configuración.
CreateImport.exe
Utilice este ejecutable para revisar y aplicar el paquete creado con Export.
Para usar CreateImport.exe, primero asegúrese de haber copiado el directorio MC en una ruta local de una máquina con acceso a su base de datos del ambiente de producción (el directorio contiene todos los ejecutables y dlls necesarios). El archivo de exportación (.bex) creado anteriormente debe ser accesible desde su ambiente de producción.
La ejecución de este archivo utiliza la siguiente estructura:
CreateImport.exe --DSNDB "..." --Provider "..." --FilePath "..." --Log "..." --ErrorLogger "..." --Config "..."
Notas de los parámetros y descripciones:
•DSNDB: String de conexión a la base de datos fuente del proyecto. Este parámetro es obligatorio y se debe incluir en la línea de comandos o en el archivo config.
Al usar SQL Server:
"Persist Security Info=True;User ID=[SQL_Login];Password=[Login_password];Data Source=[DB_Server]\[Named_instance];Initial Catalog=[Database];"
o[SQL_Login]: La cuenta usada para conectarse a la instancia de base de datos de SQL Server.
o[Login_password]: La contraseña correspondiente al Log in anterior.
o[DB_Server]: Nombre o dirección IP del servidor de base de datos. Use \[Nombre de la instancia] cuando aplique, si su instancia de la base de datos no es la que no está nombrada por defecto.
o[Database]: El nombre de la base de datos del ambiente del proyecto. Recuerde que para CreateDatabase, está base datos que se especifique es la que será creada.
Al usar Oracle:
"Data Source=[DB_Server]:[Port_number]/[Service];User ID=[User_schema];Password=[User_schema_password];Unicode=True;"
o[DB_Server]: Nombre o dirección IP del servidor de bases de datos.
o[Port_number]: El puerto TCP utilizado para la conexión al servicio de la base de datos.
o[Service]: La identificación del servicio para una instancia de Oracle.
o[User_schema]: El nombre de la base de datos del ambiente del proyecto. Recuerde que para CreateDatabase, la base de datos especificada es la que se creará.
o[User_schema_password]: La contraseña correspondiente para el User Schema. Es altamente recomendable cifrar la contraseña usando la funcionalidad de Cifrado de contraseñas.
•Provider: Cliente de la base de datos del proyecto fuente. Este parámetro es obligatorio y se debe incluir en la línea de comandos o en el archivo config. Los valores posibles son: "MSSqlClient" o "Oracle".
•FilePath: nombre del archivo .bex generado antes. Este parámetro es obligatorio y se debe incluir en la línea de comandos o en el archivo config.
•Log: Archivo en donde las trazas de la ejecución del deployment se registrarán. Este parámetro es opcional.
•ErrorLog: Archivo donde los errores durante la ejecución del deployment se registrarán. Este parámetro es opcional.
•Config: Archivo JSON donde se establece la configuración. Este parámetro es obligatorio en caso de que los parámetros no hayan sido definidos en la línea de comandos. Debe tener los mismos parámetros obligatorios mencionados anteriormente.
Ejemplo:
{
"DSNDB": "Persist Security Info=True;User ID=[SQL_Login];Password=[Login_password];Data Source=[DB_Server]\\[Named_instance];Initial Catalog=[Database];;",
"Provider": "MSSqlClient",
"FilePath": "input.bex",
"Log": "log.txt",
"ErrorLogger": "error.txt"
}
|
Si bien algunos parámetros son obligatorios, si se ejecuta el comando sin parámetros, se ejecutará el CreateImport con su interfaz gráfica donde se pedirán los detalles que se establecen de otra manera en los parámetros. |
¿Qué sigue?
Cuando haya terminado el deployment de su proceso usando el Deployment por Línea de Comandos, se recomienda limpiar la caché de su servidor antes de anunciar que se ha completado el proceso de deployment.
Cuando ejecute sus procesos en un IIS, después de realizar el Deployment por Línea de Comandos, debe limpiar la caché de su Portal de Trabajo y de la base de datos. Para hacerlo invoque los siguientes servicios web de Bizagi que están disponibles en todos los proyectos:
•Limpiar la caché de la base de datos y del Portal de Trabajo: http://[your_server][your_project]/webservices/cache.asmx?op=CleanRenderCache
•Limpiar la caché de la aplicación: http://[your_server][your_project]/webservices/cache.asmx?op=CleanUpCache
Después de hacer esto, reinicie sus servicios IIS.