Actualizar de 1.2 a 1.3 · SIU-Araí: Documentos

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

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.2
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.2 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 9.6 y máxima 12

Procedimiento

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

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

Preparar accesos y versiones

Definir la versión a utilizar

export VERSION=1.3.0
export VERSION_ANTERIOR=1.2.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:$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
   ARAI_REGISTRY_URL=http://registry/registry
   ARAI_REGISTRY_USER=registry
   ARAI_REGISTRY_PASS=registry
   " > 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_11.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:$VERSION \
   --db-update --no-interaction --no-progress

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.2.

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.2 a la 1.3 se renombraron algunas variables de entorno.

Se eliminaron las siguientes variables de entorno:

Variable
ARAI_DOCS_REPO_CONECTOR
ARAI_DOCS_REPO_SISTEMA
ARAI_DOCS_REPO_INSTALACION
ARAI_DOCS_REPO_RDI_SERVICE
ARAI_DOCS_REPO_LOG_DIR
ARAI_DOCS_REPO_LOCAL_TMP_DIR

Nuxeo vs S3

No disponible migracion entre Nuxeo y S3

Nuxeo

Si continua utilizando Nuxeo renombrar las siguientes variables:

Variable anterior	Variable nueva
ARAI_DOCS_REPO_HOST	ARAI_DOCS_NUXEO_HOST
ARAI_DOCS_REPO_USUARIO	ARAI_DOCS_NUXEO_USUARIO
ARAI_DOCS_REPO_CLAVE	ARAI_DOCS_NUXEO_CLAVE

Si utiliza S3 debe crear y modificar las siguientes variables:

Reemplazar ARAI_DOCS_REPO_TIPO

Variable Valor

ARAI_DOCS_REPO_TIPO S3
Compleltar las siguientes variables

Variables S3

ARAI_DOCS_S3_ENDPOINT

ARAI_DOCS_S3_KEY

ARAI_DOCS_S3_SECRET

ARAI_DOCS_S3_REGION

ARAI_DOCS_S3_VERSION

ARAI_DOCS_S3_BUCKET

Variables S3
ARAI_DOCS_S3_ENDPOINT
ARAI_DOCS_S3_KEY
ARAI_DOCS_S3_SECRET
ARAI_DOCS_S3_REGION
ARAI_DOCS_S3_VERSION
ARAI_DOCS_S3_BUCKET