Microservicio st-microservice-notifier¶

Permite el envío de notificaciones a través de correo electrónico.

Para realizar el despliegue se deben seguir las siguientes indicaciones:

DDL¶

En el archivo resources/database/ddl/st-microservice-notifier.sql se encuentra el script para crear el DDL que necesita el microservicio.

Se debe descargar y ejecutar el script:

$ psql -h <host> -p <puerto> -U <usuario> -d <nombre-base-datos> -f st-microservice-notifier.sql

Por ejemplo:

$ psql -h localhost -p 5432 -U postgres -d sistema-transicion -f st-microservice-notifier.sql

Configurar propiedades¶

En el archivo st-microservice-notifier.yml se encuentran las propiedades de configuración del microservicio. Se pueden modificar las siguientes propiedades:

URL Servidor Eureka¶

Si se requiere cambiar la url del servidor de descubrimiento eureka, se debe modificar la siguiente propiedad:

eureka:
  client:
    serviceUrl:
      defaultZone: http://st-eureka-server:8762/eureka

Conexión base de datos¶

Si se requiere cambiar las credenciales de conexión a la base de datos, se deben modificar las siguientes propiedades:

datasource:
    url: jdbc:postgresql://192.168.0.3:5432/sistema-transicion
    username: postgres
    password: 123456

Correo electrónico¶

Si se requiere cambiar las credenciales que se utilizan para enviar correos electrónicos, se deben modificar las siguientes propiedades:

mail:
    protocol: smtp
    host: smtp.gmail.com
    port: 465
    username: ejemplo@gmail.com
    password: 123456
    properties:
      mail:
        smtp:
          auth: true
          ssl:
            enable: true

Variables en los correos¶

El microservicio en cada uno de los correos electrónicos, envía la url del sitio web con el objetivo que el usuario pueda ingresar al sistema y a su vez envía una dirección de correo electrónico a la cual los usuarios pueden escribir. A partir de esto si se requiere modificar estos datos, se deben modificar las siguientes propiedades en el archivo application.yml

st:
  site:
    url: https://st-agencia.proadmintierra.info/login
    email: soporte_ST@proadmintierra.info

Conexion RabbitMQ¶

El microservicio realiza procesos en segundo plano a partir de un sistema de colas proporcionado por RabbitMQ, por lo cual si se requiere cambiar las credenciales de conexión con el servicio de RabbitMQ se deben modificar las siguientes propiedades en el archivo application.yml:

rabbitmq:
    host: st-rabbit
    port: 5672
    username: guest
    password: guest

Clonar repositorio¶

Se debe clonar el repositorio st-microservice-notifier almacenado en github y posteriormente generar el jar del proyecto a través de maven.

$ git clone https://github.com/SwissTierrasColombia/st-microservice-notifier.git
$ cd st-microservice-notifier && git checkout master
$ mvn clean package -DskipTests

Crear imagen docker¶

Se debe crear la imagen docker a partir del archivo Dockerfile que se encuentra en el repositorio, esta imagen requiere que se le pasen los siguientes argumentos:

XMX: Límite en RAM que el jar utilizará.
PROFILE: Perfil o ambiente en el cual se ejecutará el jar. En producción se debe usar el perfil production.
CLOUD_CONFIG: Url del servidor de configuración.

$ docker build -t st-microservice-notifier:lynx --build-arg XMX=<xmx> --build-arg PROFILE=<perfil> --build-arg CLOUD_CONFIG=<url-cloud-config> .

Por ejemplo:

$ docker build -t st-microservice-notifier:lynx --build-arg XMX=1024m --build-arg PROFILE=production --build-arg CLOUD_CONFIG=http://st-config-server:8890 .

Ejecutar el contenedor¶

Se debe ejecutar el contenedor a partir de la imagen creada asignando un límite de memoria RAM y la red docker previamente creada.

$ docker run -P -t --network <nombre-red-docker> -m <ram> -d st-microservice-notifier:lynx

Por ejemplo:

$ docker run -P -t --network st -m 500M -d st-microservice-notifier:lynx