VIRIDIAN Digital Banking - Backend 5.2.30

Changelog

Tags:

• viridian-config
• vdb-routes-internal
• manager-api
• manager-hosted
• notifications-hosted
• assistant-requests
• ansible
• vault

Modo de aplicación: En frío (con mantenimiento)

Fecha: lunes, 30 de marzo de 2026

Tareas previas

info

Les solicitamos por favor realicen los pasos Selección de versión del release y Descarga de componentes en horario de oficina para poder tener todo el equipo a disposición en caso de error.

Selección de versión del release

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml -t select -e="version=5.2.30"

   info

   Este comando selecciona la versión del release.

Descarga de componentes

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml -K -t warmup

   info

   Este comando descarga las nuevas versiones de todos los componentes que serán actualizados.

Instrucciones

Habilitar el mantenimiento

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml -K -t maintenance-enable

   info

   Este comando habilita el modo mantenimiento.

Cambios en base de datos

1. Ninguno

Cambios en los servidores

1. En el servidor de administración, ejecutar los siguientes comandos ansible:

   ansible-playbook admin.yml -K -t stop-netcore

   ansible-playbook admin.yml -K -t stop-spring

2. En el servidor de administración, ejecutar el siguiente comando:

   cp defaults/local_vars.yml defaults/local_vars.yml.bk

   warning

   Este comando creará un backup del archivo defaults/local_vars.yml.

Cambios en vault

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook vault.yml -K -t generate-microservice-token

   warning

   Este comando generará un nuevo token de vault para los microservicios. El nuevo token se guardará encriptado en defaults/local_vars.yml y desencriptado en defaults/vault_microservice_token.yml. Este último archivo debe ser copiado y eliminado del servidor.

2. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook os.yml -K -t setup-env

   warning

   Este comando modificará el archivo /opt/viridian/.env en todos los servidores para que los microservicios utilicen el nuevo token.

Cambios en ansible

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-vault encrypt defaults/local_vars.yml

   info

   Este comando iniciará un proceso interactivo para encriptar el archivo defaults/local_vars.yml que contiene valores sensibles. Al ejecutar el comando, se pedirá una variable, para la cual se debe ingresar el valor y luego presionar ENTER:

   New Vault password: La contraseña que se pedirá de ahora en adelante para desencriptar el archivo defaults/local_vars.yml. Se sugiere que la contraseña cumpla con los siguientes requisitos:

   • Contenga mayúsculas, minúsculas, números y símbolos
   • Contenga de 12 a 30 caracteres Esta contraseña no será almacenada en ningún archivo dentro del entorno. Se sugiere almacenarla en un Gestor de Contraseñas.
   warning

   De ahora en adelante los comandos de ansible incluirán una directiva extra: --ask-vault-pass. Esta directiva indica al comando que se debe pedir la contraseña para desencriptar los archivos de ansible vault, en este caso defaults/local_vars.yml. Después de ejecutar los comandos ansible, una vez que se haya introducido la contraseña del usuario adminv en el prompt BECOME password:, aparecerá en la línea de comandos el siguiente prompt:

   Vault password: Debe introducirse la contraseña para desencriptar defaults/local_vars.yml.

2. En el servidor de administración, ejecutar el siguiente comando:

   chmod 644 defaults/local_vars.yml

   warning

   Este comando permitirá a Ansible UI leer el archivo defaults/local_vars.yml para ejecutar comandos ansible.

Cambios en ansible UI

1. Leer la sección Ansible del apartado de Administración para importar el archivo ansible_vdb_300326.yml enviado en el email que corresponde al release y preparar el componente Ansible UI para su uso en futuros releases. Este paso puede realizarse en otro momento y no necesariamente en conjunto con el resto del release. No afecta el funcionamento de la solución y puede aplicarse en cualquier momento del día. Sin embargo, la preparación de Ansible UI debe hacerse antes del siguiente release, porque muchas de las instrucciones ahora se ejecutarán por ese medio.

Cambios en componentes

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook release.yml --ask-vault-pass -K -t deploy -e "type=cold"

Limpieza de archivos generados por el release

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml --ask-vault-pass -K -t cleanup

Verificación de componentes

1. En los servidores de aplicaciones, ejecutar el siguiente comando:

   docker ps -vs

   info

   Este comando muestra el estado de todos los docker containers ordenados alfabéticamente.

2. Revisar el output del comando y asegurarse de que todos los docker containers tengan un status UP y no haya ningún docker container detenido.

Deshabilitar el mantenimiento

1. En el servidor de administración, ejecutar el siguiente comando ansible:

   ansible-playbook admin.yml --ask-vault-pass -K -t maintenance-disable

   info

   Este comando deshabilita el modo mantenimiento.

Backup

1. Una vez finalizada correctamente la aplicación del release, el archivo defaults/local_vars.yml.bk puede ser eliminado.

   info

   Si por prudencia se quisiera mantener el archivo defaults/local_vars.yml.bk, se deberá guardar una copia fuera del entorno de producción antes de eliminar defaults/local_vars.yml.bk del servidor de administración

Resumen de versiones

componente	release 5.2.29	release 5.2.30
viridian-config-properties	9.24.1	9.25.0
server-config	9.1.0
server-eureka	9.1.0
vdb-routes-public	9.9.0
vdb-routes-internal	9.2.0	9.3.0
vdb-routes-bank	9.3.0
gateway-public	9.3.1
gateway-internal	9.3.1
gateway-external	9.2.0
bank-gateway	9.6.0
bank-service	9.3.0
batchpayments-api	9.3.0
batchpayments-hosted	9.3.0
beneficiaries-api	9.5.0
digitalcredit-api	9.3.0
digitalpay-qr	9.13.0
guaranteebond-api	9.3.0
manager-api	9.17.0	9.18.0
manager-hosted	9.8.2	9.9.0
myfinances-api	9.4.0
notifications-hosted	9.6.0	9.7.0
onboarding-api	9.14.1
servicepayments-api	9.5.1
statements-api	9.5.0
trade-api	9.5.0
transactions-api	9.9.0
transactions-hosted	9.3.0
utilities-api	9.8.0
wiretransfer-api	9.4.1
insurance-agents	9.3.0
insurance-sales	9.3.0
assistant-requests	9.5.0	9.6.0
frontend-vdb	9.10.0
frontend-vdb-2	9.10.0
frontend-admin	9.6.0
frontend-kiosk	9.2.0