Actualizacion de 1.12 a 1.13

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.12.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.12.x a 1.13.0

---

Resumen de actualización

Se actualizará:

• Sudocu a v1.6.3.
• SIU-Huarpe a v3.8.0.
• Arai-Documentos a v1.8.2.
• Arai-Solicitudes a v1.1.1.

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

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 las bases de datos que se actualizarán.

Documentos

En la versión 1.8.2 de Arai-Docs solo se corrigen errores menores. Los cambios se detallan acá.

Escalar despliegues de Documentos a 0 (cuando aplique)

kubectl scale deployment docs-api docs-worker --replicas=0 -n <namespace>

Actualización de bases de datos de Documentos

Modifique uunn-overlay/jobs/documentos/init-update/kustomization.yaml

resources:
- ../../../../siu-k8s/base-eei/1.13.0/arai/documentos/jobs/init-update/

Ejecute:

kustomize build --load-restrictor LoadRestrictionsNone documentos/init-update | kubectl apply -f -

Arai Solicitudes (Opcional)

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

Escalar despliegues de Arai Solicitudes a 0 (cuando aplique)

kubectl scale deployment solicitudes-api --replicas=0 -n <namespace>

Actualización de bases de datos de Arai Solicitudes

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

resources:
- ../../../../siu-k8s/base-eei/1.13.0/arai/solicitudes/jobs/update/

Ejecute:

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

SUDOCU

Se trata de una versión con mínimos cambios.

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.13.0/sudocu/jobs/update

Ejecute:

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

Paso 2: Despliegue de aplicaciones

Documentos

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

resources:
- ../../../siu-k8s/base-eei/1.13.0/documentos

kustomize build --load-restrictor LoadRestrictionsNone apps/documentos/ | kubectl apply -f -

Arai Solicitudes (Opcional)

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

resources:
- ../../../siu-k8s/base-eei/1.13.0/solicitudes

kustomize build --load-restrictor LoadRestrictionsNone apps/solicitudes/ | kubectl apply -f -

Sudocu

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

resources:
- ../../../siu-k8s/base-eei/1.13.0/sudocu

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

Huarpe

Se realizan varias mejoras en la bandeja, todas funcionales.

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

resources:
- ../../../siu-k8s/base-eei/1.13.0/huarpe

kustomize build --load-restrictor LoadRestrictionsNone apps/huarpe/ | kubectl apply -f -

Luego de realizar el deploy de cada servicio

Es necesario escalar a las réplicas correspondientes cada una de los servicios correspondientes que previamente fueron llevados a 0 réplicas, para que los servicios queden nuevamente operativos.

1.13.0 a 1.13.1

Arai-Documentos

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

2. Desplegar las nuevas versiones

Para actualizar la aplicación debe editar la versión especificada en el archivo overlay/apps/documentos/kustomization.yaml referida en la sección "resources":

resources:
- ../../../siu-k8s/base-eei/1.13.0/documentos

modifiquelo por la versión 1.13.1

resources:
- ../../../siu-k8s/base-eei/1.13.1/documentos

Una vez reflejado dicho cambio, guarde el archivo y ejecute el siguiente comando para desplegar el job que actualizará la versión de documentos

kustomize build --load-restrictor LoadRestrictionsNone overlay/apps/documentos | kubectl apply -f -