Implementación del paquete
Implementar un paquete implica ejecutar un paquete ensamblado previamente (en este caso, el VT_FULL_IMPLE) en el entorno del cliente, aplicando configuraciones, transacciones y todos los demás elementos incluidos en el paquete.
Este proceso puede ser:
Manual: para entornos locales.
Automatizado: vía Jenkins.
Lee Business Application Package para aprender a crear un BAP y cómo convertir el paquete a una versión estable para su entrega.
Importante
Después de que los cambios impacten en el entorno objetivo, el usuario a cargo de la versión puede descargar un registro de cambios para comparar la nueva versión de la aplicación con la anterior y generar documentación para el cliente.
Prerrequisitos
Antes de iniciar una implementación con Jenkins o VT-Wizard, necesita un paquete ya ensamblado y un API token que se utilizará al ejecutar la implementación de BAP.
Para crear un token, sigue estos pasos:
Inicia sesión en Workspace.
Selecciona New API Token.
Completa el nombre del token con bap_deployer_token.
Selecciona todos los permisos para el grupo BAPDEPLOYER.
Crea y guarda el API Token generado.
Este tipo de despliegue lleva el paquete de implementación completo al ambiente de destino y ejecuta los scripts de VT-Wizard.
Importante
Este método solo debe usarse para ambientes locales que no permiten una implementación a través de Jenkins.
Sigue estos pasos para desplegar el paquete manualmente:
Transfiere el paquete FULL_IMPLE al servidor de destino y guárdalo en la carpeta de implementación estándar (por ejemplo, /opt/veritran/packages). Puedes usar scp, FTP u otro método de transferencia.
Descomprime el paquete FULL_IMPLE en el servidor de destino:
tar -xvzf VT-FULL-IMPLE_TEST_BAP_V001.tar.gz
Descomprime el archivo de objetos VT-NET:
tar -xvzf IMPLE_VTNET_OBJECTS.tar.gz
Ejecuta VT-Wizard con los siguientes parámetros:
./vt-wizard/vt-wizard-core.sh \ -s /path/to/imples/IMPLE_BAP_V001/ \ -d /veritran/ \ -e <SERVER_CODE_NAME> \ -n <NODE_NAME> \ -k <WORKSPACE_TOKEN>
(s = ruta de origen de la carpeta de implementación, d = carpeta de destino (comúnmente /veritran/), e = nombre del código del servidor, n = nombre del nodo, k = token de Workspace con permisos de BAP Deployer)
VT-Wizard genera un log de ejecución que debe mantenerse por razones de auditoría.
Inicia sesión en Jenkins y selecciona el trabajo correspondiente al cliente/paquete.
Haz clic en Build with Parameters.
Completa los siguientes campos:
IMPLENAME: Nombre de la carpeta de implementación en el repositorio.
NODE: Nodo donde se ejecutará la implementación.
TOKEN: Introduce el token generado en Workspace.
Marca la opción Execute.
Ejecuta la build. La herramienta debe marcar el proceso con el estado Success cuando esté lista.
Después del despliegue
Después de despliegues manuales o automatizados, debes ejecutar un warmboot para aplicar cambios. Para hacerlo, ve a la consola de Middleware y haz clic en Operator en el menú superior. Luego, ejecuta el siguiente comando:
WARMBOOT proc .*
Importante
Verifica con el equipo interno de TI del proyecto si hay algún otro comando adicional que debas ejecutar después de cada despliegue.
La consola Middleware también reflejará información actualizada. Para verificar que el despliegue se ejecutó correctamente:
Ve a User Application > Configuration Management y busca el tipo de configuración (configuration type) de tu app. Valida la versión de BAP.
Ve a Auth > Transactions y valida las transacciones actualizadas, si aplica.
Después de que los cambios impacten en el ambiente destino, el usuario a cargo del release puede descargar un changelog para comparar la nueva versión de la aplicación con la anterior y generar documentación para el cliente.