v3.1.13

Inicializar base de datos PostgreSQL

Si sólo desea ver el sistema corriendo vaya a la guía de Instalación Rápida.

La base de datos PostgreSQL se utiliza para el almacenamiento la información que gira en torno al usuario, los servicios que éste puede acceder, entre otros.

Consideraciones hechas para el proyecto SIU-Araí: Usuarios:

  • Se requiere de un servicio de SQL, externo a la plataforma.
  • La implementación actual se basa en un servicio PostgreSQL v12+.
  • Se provee una imagen Docker pre-armada con un mecanismo para inicializar la estructura.

Previo al uso de SIU-Araí: Usuarios es necesario generar las estructuras necesarias para el correcto funcionamiento.

Preparar accesos y versiones

  1. Definir la versión a utilizar

    export VERSION=v3.1.0

  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/arai-usuarios/idm:$VERSION

Preparando la estructura

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

    Para poder realizar la creación de los esquemas de la base de datos, es neceario configurar unas variables de entorno para conectarse a PostgreSQL respectivamente. Ajustarlo a los parametros requeridos.

    echo \
"#configurar ENV temporal
DB_HOST=ip_pg_host
DB_PORT=5432
DB_DBNAME=usuarios
DB_USERNAME=user
DB_PASSWORD=pass
DB_SCHEMA=usuarios
IDM_URL=http://nada
TOBA_USUARIO=nada
TOBA_PASSWORD=nada" > migrar.env

  2. Para inicializar la estructura deberemos ejecutar el comando que creará la estructura de negocios antes mencionada:

    docker run --rm \
  --env-file migrar.env \
  hub.siu.edu.ar:5005/siu-arai/arai-usuarios/idm:$VERSION \
  --db-initialize

Problemas con la migración

En caso de que tenga inconvenientes, puede revisar la salida que produce el instalador. Una forma es ejecutar el contenedor de forma persistente (sin el flag --rm) para luego copiar el contenido del log.

  1. Inicializar la estructura de la base de datos PostgreSQL, pero manteniendo el contenedor generado:

    docker run --name migrar-db-usuarios \
  --env-file migrar.env \
  hub.siu.edu.ar:5005/siu-arai/arai-usuarios/idm:$VERSION \
  --db-initialize

  2. Copiar el archivo de log que contiene el resultado0 de la ejecución del instalador

    docker cp migrar-db-usuarios:/usr/local/app/idm/instalador.log .

  3. Revisar el error del proceso en el archivo instalador.log

← LDAPDocker →