Documentation for a newer release is available. View Latest

UTILS3 - Simulador de sanciones

Este documento explica cómo usar el simulador de sanciones. Hay dos enfoques recomendados para el tutorial: con docker y sin docker. Veámoslos:

Utilizar la aplicación a través de Docker

A continuación se muestra una entrada simple de docker para el simulador de sanciones:

  sanctions-sim:
    image: registry.ipf.iconsolutions.com/sample-systems-sanctions-simulator-kafka:2.1.47
    container_name: sanctions-sim
    ports:
      - 5010:5005
      - 8088:55555
    environment:
      - SANCTIONS_MODE=normal
      - SANCTIONS_TRANSPORT=kafka
      - SANCTIONS_SIM_ENCRYPTION_ENABLED=FALSE
    volumes:
      - ./config/sanctions-sim:/sanctions-simulator-kafka/conf
      - ./logs:/ipf/logs
    user: "${UID:-1000}:${GID:-1000}"
    depends_on:
      - kafka

Además, la aplicación necesitará configuración, que se coloca en el archivo application.conf dentro de un directorio config relativo a la entrada de docker anterior. El archivo de configuración contiene:

common-kafka-client-settings {
  bootstrap.servers = "kafka:9092"
}

akka.kafka {
  producer {
    kafka-clients = ${common-kafka-client-settings}
  }
  consumer {
    kafka-clients = ${common-kafka-client-settings}
  }
}

Al ejecutarse, el simulador de sanciones escuchará datos en el topic SANCTIONS_REQUEST y publicará en SANCTIONS_RESPONSE. Los logs se exportarán a logs/ipf-developer.app relativo al archivo de docker.

Utilizar la aplicación sin Docker

Prerrequisitos

Para ejecutar este simulador se requiere:

  • Un runtime de Java 17

  • Un entorno Kafka que tenga:

    • Creación automática de topics habilitada

    • Topics creados para SANCTIONS_REQUEST y SANCTIONS_RESPONSE

Opciones de configuración

Propiedad

Descripción

Valor por defecto

common-kafka-client-settings.bootstrap.servers

Define los ajustes de bootstrap del servidor para kafka.

localhost:9092

server.port

Define el puerto en el que se ejecutará la aplicación

8082

simulator.http.port

Define el puerto en el que escuchar solicitudes http.

55555

Descarga

El simulador de sanciones está disponible aquí:

nexus.ipf.iconsolutions.com/repository/ipf-releases/com/iconsolutions/ipf/sample/samplesystems/sanctions-simulator-kafka/2.1.47/sanctions-simulator-kafka-2.1.47-runnable.jar

Ejecución

Una vez descargado, colócalo en este directorio y ejecuta:

java -cp "sanctions-simulator-kafka-2.1.47-runnable.jar:config" -D"loader.main"="com.iconsolutions.samplesystems.sanctions.simulator.SanctionsSimulatorKafkaApplication" "org.springframework.boot.loader.launch.PropertiesLauncher"

La aplicación se iniciará y estará disponible en:

localhost:55555/index.html

Ten en cuenta que en Windows, los dos puntos en el comando de ejecución deben reemplazarse por un punto y coma.