Actualizacion de 1.11 a 1.12
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.11.0 (última al generar esta guía, no se probaron versiones previas)
- Se actualiza toda la solución EEI que se despliega con Docker
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.11.x a 1.12.0
Resumen de actualización
Se actualizará:
- Documentos a v1.8.1
- Portal del Proveedor basado en SIU-Huarpe de v3.5.0 a v3.7.0
- Proveedores a v2.1.3
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 Arai-Documentos.
Arai-Documentos
Como novedad, esta versión incorpora una nueva API al servicio documentos (llamanda archivos); también se divide el punto de acceso a la API de frontend respecto a la de backend. Ahora se identifica los nuevos servicios dentro de docoumentos de la siguiente forma: docs-api-frontend, docs-api-archivos, docs-worker, docs-api-backend (aunque el nombre del Service se mantiene como docs-api para conservar la coherencia con las referencias existentes y evitar tener que actualizar configuraciones en otros lugares donde ya se utiliza).
Actualizar variables
En la versión 1.8 de Arai-Docs se agregaron nuevas configuraciones. Los cambios se detallan acá.
Paso 1: Actualización
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>
Actualizar las configuraciones
En este punto, debemos actualizar los secrets que involucran a Arai-Documentos, ya que fue necesario ajustar el formato JSON de configuración. Estos se encuentran en el archivo secrets/docs-secrets.env, a cada uno de ellos se les debe eliminar las comillas y ajustar la configuración de c/u acorde a las necesidades, ej: manteniendo el password utilizado.
Ejemplo el secret viejo de conexión con Araí Usuarios esta asi:
USUARIOS_PARAMS="{base_uri:'http://usuarios-api.template-universidad/api/v1/usuarios', method:'basic', user:'user', password:'pass'}"
El cual deberia quedar de la siguiente manera, al igual que los secrets de PERSONAS_PARAMS, SERVICIO_FIRMAR_PARAMS, TRAMITES_PARAMS.
USUARIOS_PARAMS={base_uri:'http://usuarios-api.template-universidad/api/v1/usuarios', method:'basic', user:'user', password:'pass'}
Antes de actualizar
Antes de actualizar es necesario realizar un backup de la base de datos.
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.12.0/arai/documentos/jobs/init-update/
Ejecute:
kustomize build --load-restrictor LoadRestrictionsNone documentos/init-update | kubectl apply -f -
Paso 2: Actualización y despliegue de aplicaciones
Documentos
Modifique uunn-overlay/apps/documentos/kustomization.yaml:
resources:
- ../../../siu-k8s/base-eei/1.12.0/documentos
kustomize build --load-restrictor LoadRestrictionsNone apps/documentos/ | kubectl apply -f -
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.
Es necesario actualizar los parámetros de conexión del servicio Documentos en el archivo config-api-server.json con los nuevos valores.
Se recomienda comparar estos parámetros con los definidos en el archivo template (actualizado) correspondiente, y ajustar únicamente aquellos que difieran.
Modifique uunn-overlay/apps/sudocu/kustomization.yaml:
resources:
- ../../../siu-k8s/base-eei/1.12.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.12.0/huarpe
kustomize build --load-restrictor LoadRestrictionsNone apps/huarpe/ | kubectl apply -f -
Proveedores (opcional)
Modifique uunn-overlay/apps/proveedores/kustomization.yaml:
resources:
- ../../../siu-k8s/base-eei/1.12.0/proveedores
kustomize build --load-restrictor LoadRestrictionsNone apps/proveedores/ | kubectl apply -f -