Saltar al contenido principal
Version: Next

Actualizacion de 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

Changelog

Actualizacion de repositorios

k8s-deployment: para actualizar su repositorio con los commits más recientes de k8s-deployment, es necesario realizar un pull del repositorio upstream.

git pull upstream main

siu-k8s: para poder reflejar los nuevos cambios de cada version en su entorno es necesario actualizar de su repositorio el submodulo.

Para esto, estando parado en el directorio padre, debe utilizar el siguiente comando:

git submodule update --remote

Actualizacion Mayor

1.10.x a 1.11.0​

Resumen de actualización​

Se actualizará:

  • Huarpe a v3.5.0
  • Usuarios a v3.3.1
  • Sudocu a v1.6.1
  • Solicitudes a v1.0.1
  • Proveedores a v2.1.2

Deberá apuntar a la nueva versión de EEI. La mayoria de cambios no requiere modificaciones en configMap o Secrets, excluyendo la nueva version de Sudocu.

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.

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 uunn-overlay/apps/sudocu/config/sudocu-web.env, 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

Paso 1: Actualización​

Recordatorio

Previo a ejecutar los siguientes comandos para desplegar los pods, recuerde ubicarse dentro de la carpeta de su overlay, de esta manera podrá copiar y pegar los comandos correctamente en su terminal.

cd <uunn-overlay>

Antes de actualizar​

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

Escalar despliegues de Sudocu a 0 (cuando aplique)​

kubectl scale deployment sudocu-api-server sudocu-api-worker sudocu-cache sudocu-gestion sudocu-login sudocu-mpc sudocu-mpd sudocu-pdf --replicas=0 -n <namespace>

Actualización de bases de datos de Sudocu​

Modifique uunn-overlay/jobs/sudocu/update/kustomization.yaml

resources:
- ../../../../siu-k8s/base-eei/1.11.0/sudocu/jobs/update

Ejecute:

kustomize build --load-restrictor LoadRestrictionsNone jobs/sudocu/update | kubectl apply -f -

Paso 2: Actualización y despliegue de aplicaciones​

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.

Modifique uunn-overlay/apps/sudocu/kustomization.yaml:

resources:
- ../../../siu-k8s/base-eei/1.11.0/sudocu
kustomize build --load-restrictor LoadRestrictionsNone apps/sudocu/ | kubectl apply -f -

Huarpe​

Modifique uunn-overlay/apps/huarpe/kustomization.yaml:

resources:
- ../../../siu-k8s/base-eei/1.11.0/huarpe
kustomize build --load-restrictor LoadRestrictionsNone apps/huarpe/ | kubectl apply -f -

Usuarios​

Modifique uunn-overlay/apps/usuarios/kustomization.yaml:

resources:
- ../../../siu-k8s/base-eei/1.11.0/usuarios
kustomize build --load-restrictor LoadRestrictionsNone apps/usuarios/ | kubectl apply -f -

Solicitudes​

Modifique uunn-overlay/apps/solicitudes/kustomization.yaml:

resources:
- ../../../siu-k8s/base-eei/1.11.0/solicitudes
kustomize build --load-restrictor LoadRestrictionsNone apps/solicitudes/ | kubectl apply -f -

Proveedores​

Modifique uunn-overlay/apps/proveedores/kustomization.yaml:

resources:
- ../../../siu-k8s/base-eei/1.11.0/proveedores
kustomize build --load-restrictor LoadRestrictionsNone apps/proveedores/ | kubectl apply -f -