Saltar al contenido principal
Version: 1.11.0

Actualizar desde versiones 1.10 a 1.11

Consideraciones​

Esta guía lo lleva en el proceso de actualizar una instalación pre-existente de EEI. Tenga en cuenta que:

  • La versión requerida de EEI en ejecución es la v1.10.0 (última al generar esta guía, no se probaron versiones previas)
  • Se actualiza toda la solución EEI que se despliega con Docker

SUDOCU​

A partir de la versión 1.5.0 de SUDOCU se eliminó el módulo de login tradicional (sudocu-login), reemplazándolo por una nueva arquitectura centrada en autenticación SAML y unificación de servicios. Se incorporaron dos nuevos componentes clave: sudocu-api2, un backend desarrollado en NestJS que mejora la escalabilidad y separación de responsabilidades, y sudocu-web, una nueva interfaz centralizada que consolida el acceso a todos los módulos. Esta actualización sienta las bases para una experiencia de usuario más integrada y una arquitectura más moderna y mantenible.

sudocu.yml:​

Nuevos servicios incorporados:​

  • api-server2: nuevo backend en NestJS (/api2). Por el momento van a convivir api-server y api-server2, hasta tanto api-server pueda ser deprecado.
  • sudocu-web: Nueva interfaz web unificada con configuración dinámica y soporte multientorno.

Servicio eliminado:​

  • sudocu-login: El servicio sudocu_login a partir de 1.5.0 se reemplaza por sudocu_web

Environment en nuevos servicios:​

Se agregan en los servicios web y api-server-2 una serie de variables de entorno en sudocu.yml, a las cuales tambien es necesario reemplazar el uunn.local por el dominio del despliegue.

Cambios en SAML en la configuración de la aplicación SUDOCU en ARAI-USUARIOS:​

Por último en la solapa SAML en ARAI-USUARIOS se deben setear las variables de esta manera:

Para más información sobre las novedades en SUDOCU 1.5.0 visitar página oficial de SUDOCU

Cambiar dominio​

En los archivos de configuración se asume el dominio uunn.local, para cambiarlo por el dominio definitivo puede utilizar el siguiente comando (reemplace universidad.edu.ar por el dominio real)

sed -i 's/uunn.local/universidad.edu.ar/g' \
    prod/sudocu/sudocu.yml

Actualización​

Antes de actualizar​

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto.

Actualizar base PostgreSQL​

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.6.1

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión​

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu

Nota: Tener en cuenta que en muchos casos hay nuevas opciones en los JSON de configuración (archivo config-api-server.json), que requieren ser actualizados. Todas se detallan acá. Se sugiere revisar esto antes de desplegar nuevamente.

Portal del Proveedor (Opcional)​

Si posee desplegado el Portal del Proveedor, en esta versión se actualiza la version de la API de Proveedores.

Bajar stack proveedores​

docker stack rm proveedores

Desplegar la nueva version de la API​

docker stack deploy --with-registry-auth -c prod/modulos/proveedores/proveedores.yml proveedores

Arai Solicitudes (Opcional)​

Si posee desplegado el servicio Arai Solicitudes, en esta versión se actualiza la version de la API de Solicitudes.

Desplegar la nueva version de la API​

docker stack deploy --with-registry-auth -c prod/arai/solicitudes.yml solicitudes

Arai-Usuarios​

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

Desplegar las nuevas versiones​

docker stack deploy --with-registry-auth -c prod/arai/usuarios.yml usuarios

Huarpe​

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

Actualizar el despliegue​

docker stack deploy --with-registry-auth -c prod/arai/huarpe.yml huarpe