next

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.
  • Se requiere que la base de Arai-Usuarios este creada en UTF-8

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.3.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
DB_ENCODING=LATIN1
IDM_URL=https://uunn.local/usuarios
IDM_URL_HOST=http://localhost
IDM_URL_ALIAS=/usuarios
IDM_LOG_LEVEL=ERROR
IDM_LOG_HANDLER=errorlog
IDM_SESSION_HANDLER=memcache
IDM_SESSION_NAME=ARAI_IDM_SESSION
IDM_FORMATO_UID=simple
TOBA_USUARIO=nada
TOBA_PASSWORD=nada
TOBA_ALIAS_TOBA_EDITOR=/toba_editor
TOBA_ALIAS_NUCLEO=/toba_gestion
" > crear.env

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

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

  3. Una vez se encuentra corriendo el contenedor, nos conectamos al mismo de la siguiente forma:

    docker exec -it crear-db-usuarios bash

  4. Dentro del contenedor, primero exportar las variables de entorno:

    source /siu-entrypoint.d/01-prepare-secrets

  5. Luego se inicia la base de datos:

    idm/bin/instalador docker:db-inicializar --no-interaction --no-progress

  6. Por ultimo puede borrar el contenedor

    docker stop crear-db-usuarios
docker rm crear-db-usuarios

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 como en el apartado anterior (Paso 2) para luego copiar el contenido del log.

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

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

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

Puede borrar el contenedor al finalizar el proceso de inicializacion de la base con: docker stop crear-db-usuarios && docker rm crear-db-usuarios

← LDAPDocker →