Actualizar de 1.1 a 1.2

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

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.1
• Se deberá realizar un despliegue con imágenes Docker

La versión 1.1 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.1 a una 1.2 se deben seguir los siguientes pasos:

1. Preparar accesos y versiones
2. Resguardo de las bases de datos y assets
3. Actualizar Bases de datos
4. Desplegar contenedores

Preparar accesos y versiones

1. Definir la versión a utilizar

   export VERSION=1.2.0
   export VERSION_ANTERIOR=1.1.X
   

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

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

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

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

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