Saltar al contenido principal

Desplegar en Docker

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

Antes de comenzar​

Los requisitos mínimos para desplegar Arai-Notificaciones:

  • Docker Engine, en la versión 18.06 o superior
  • la versión de la imagen corresponde a la versión del proyecto. En este ejemplo mostramos la v1.1.0

Como desplegar​

Los siguientes pasos componen una estrategia para desplegar la API:

  1. configurar los parámetros de Arai-Notificaciones
  2. desplegar en Docker, de referencia para trasladarlo al orquestador de elección

A continuación a modo de ejemplo se detalla cada paso.

Definir parámetros​

Las imágenes Docker son configurables a través de las variables de entorno especificadas en este documento. Muchas de ellas son opcionales, pero pueden ser configuradas según sea necesario.

  • Las variables que son obligatorias para poder iniciar la API:
API_URL
API_BASIC_CLIENTES
API_XXX
  • Las variables obligatorias que especifican la conexión con la base de datos y su encoding:
DB_HOST
DB_PORT
DB_DBNAME
DB_XXX
  • Finalmente, aquellas variables que definen información de caracter funcional:
QUEUE_POLLING_INTERVAL
QUEUE_LAZY_CONNECTION
QUEUE_REDELIVERY_DELAY

Inicializar la base de datos​

Una vez definidos los parámetros de conexión a la base de datos, podemos hacer uso de una de las imágenes para generar y/o actualizar la estructura de la misma.

Nota: Previo a la ejecución de esta job se debe crear la base de datos con el identificador expresado en la variable DB_DBNAME

  1. Inicializar / Actualizar la DB

    sudo docker run --detach \
      --name notificaciones_db \
      --env-file notificaciones.env \
      hub.siu.edu.ar:5005/siu/expedientes/arai-notificaciones/db:v1.1.0

Desplegar​

Se muestra un despliegue simple con Docker Engine de una de las imágenes que se ofrecen para el proyecto Araí-Notificaciones.

La idea es que vean la flexibilidad y lo adapten al esquema que mejor crean conveniente.

  1. Configurar Arai-Notificaciones

    Generar el archivo notificaciones.env con las variables de entorno previamente definidas. Opcionalmente puede proporcionarlas mediante el flag --env.

  2. Iniciar la API

    sudo docker run --detach \
      --hostname notificaciones.uunn.local \
      --publish 9999:80 \
      --name Arai-Notificaciones \
      --restart always \
      --env-file notificaciones.env \
      hub.siu.edu.ar:5005/siu/expedientes/arai-notificaciones/api:v1.1.0

  3. Iniciar el Worker

    sudo docker run --detach \
      --name Arai-Notificaciones \
      --restart always \
      --env-file notificaciones.env \
      hub.siu.edu.ar:5005/siu/expedientes/arai-notificaciones/worker:v1.1.0