Actualizar de 1.7 a 1.8 · SIU-Araí: Documentos

Esta versión de Documentos, presenta nuevas funciones sobre la versión 1.7.

Nota: Previo a la version 1.8 el worker de Arai-Documentos podía sufrir caídas ante errores de la base de datos, a partir de esta versión se dejará constancia de los errores producidos en el log del contenedor pero no se detendrá por ellos, salvo ante excepciones del core de PHP.

A continuación se describen los pasos para realizar la actualización de versión.

NO OLVIDE REALIZAR UNA COPIA DE SEGURIDAD DE LA APLICACIÓN Y LAS BASES DE DATOS ANTES DE CONTINUAR

Consideraciones iniciales

Es necesario contar con una instalación de SIU-Araí: Documentos en la versión 1.7
Se deberá realizar un despliegue con imágenes Docker
En caso de utilizar S3, requiere los datos de conexión al mismo
No incluye migracion de datos desde Nuxeo a otro Storage (Ejemplo S3)

La versión 1.8 mantiene los requerimientos mínimos respecto a la versión anterior:

Orquestador para contenedores, con soporte a imágenes Docker
PostgreSQL requerido en versión mínima 12 y máxima 16
El uso del Stamper se torna obligatorio

Procedimiento

Para migrar de una instalación 1.7.X a una 1.8.X se deben seguir los siguientes pasos:

Preparar accesos y versiones
Resguardo de las bases de datos y assets
Actualizar Bases de datos
Actualizar configuraciones
Desplegar contenedores

Preparar accesos y versiones

Definir la versión a utilizar

export VERSION=1.8.0
export VERSION_ANTERIOR=1.7.X

Autenticarse contra la registry de imágenes Docker del SIU (utiliza credenciales del HUB)
```
docker login hub.siu.edu.ar:5005
```
Donde opere con imágenes Docker del SIU, se requiere este paso

Descargar la imagen de la nueva versión de la aplicación. Asegurarse de tener la versión adecuada

docker pull hub.siu.edu.ar:5005/siu-arai/docs-api/api-backend:v$VERSION
docker pull hub.siu.edu.ar:5005/siu-arai/docs-api/api-frontend:v$VERSION
docker pull hub.siu.edu.ar:5005/siu-arai/docs-api/api-archivos:v$VERSION
docker pull hub.siu.edu.ar:5005/siu-arai/docs-api/db:v$VERSION

Preparar la configuración de conexión a las bases de datos

Para poder realizar la migración, es necesario configurar unas variables de entorno para conectarse a PostgreSQL respectivamente. Ajustarlo a los parametros requeridos.


   echo \
   "#configurar ENV temporal
   # Variables obligatorias
   ARAI_DOCS_DB_HOST=localhost
   ARAI_DOCS_DB_PORT=5432
   ARAI_DOCS_DB_DBNAME=arai_documentos
   ARAI_DOCS_DB_USERNAME=postgres
   ARAI_DOCS_DB_PASSWORD=postgres
   # Variables no requeridas para actualizar db, pero deben estar
   ARAI_DOCS_DB_SCHEMA=public
   ARAI_DOCS_DB_ENCODING=utf8
   ARAI_DOCS_URL=localhost
   ARAI_DOCS_USER=documentos
   ARAI_DOCS_PASS=documentos
   ARAI_DOCS_LOG_HANDLER=errorlog
   ARAI_DOCS_LOG_LEVEL=ERROR
   ARAI_DOCS_TOKEN_LIFETIME=2000
   " > migrar.env

Backup de las base de datos

Realizar el backup de PostgreSQL de manera preventiva

pg_dump -b -O -x --clean --create --disable-triggers --if-exists -h ${DB_HOST} -p ${DB_PORT} -U ${DB_USERNAME} -d ${DB_DBNAME} -f dump_12.sql

Actualizar PostgreSQL

Con los datos de configuración actualizados, se migra la estructura de la base de datos en PostgreSQL

docker run --rm -it  \
   --env-file=migrar.env \
   hub.siu.edu.ar:5005/siu-arai/docs-api/db:v$VERSION

Nota: El proceso de actualización aún NO TERMINO. La siguiente sección es crucial para finalizar la actualización a la versión 1.8.

Actualizar configuración

Toda la configuración del proyecto se realiza por medio de variables de entorno. Cada módulo cuenta con un conjunto de variables que permiten su parametrización:

el templates/arai-docs.env.dist

Tabla de equivalencias

En el cambio de la versión 1.7 a la 1.8 se agregaron las siguientes variables de entorno:

Variable
ARCHIVOS_VIGENCIA
ARCHIVOS_MAX_SIZE
ARCHIVOS_RETENCION_POST_EXPIRACION