Documentation for a newer release is available. View Latest

UTILS1 - IPF Developer App

Este documento explica cómo usar la ipf-developer-app. 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 la aplicación de desarrollador:

  ipf-developer-app:
    image: registry.ipf.iconsolutions.com/ipf-developer-app:2.1.2
    container_name: ipf-developer-app
    ports:
      - 8081:8081
    volumes:
      - ./config/ipf-developer-app:/ipf-developer-app/conf
      - ./logs:/ipf/logs
    environment:
      - IPF_JAVA_ARGS=-Dma.glasnost.orika.writeClassFiles=false -Dma.glasnost.orika.writeSourceFiles=false -Dconfig.override_with_env_vars=true
    user: "${UID:-1000}:${GID:-1000}"
    depends_on:
      - ipf-mongo
    healthcheck:
      test: [ "CMD", "curl", "http://localhost:8081/actuator/health" ]

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 conf contiene:

flow-restart-settings {
  min-backoff = 1s
  max-backoff = 5s
  random-factor = 0.25
  max-restarts = 5
  max-restarts-within = 10m
}
spring.data.mongodb.uri = ${?ipf.mongodb.url}
actor-system-name = ipf-developer
ipf.mongodb.url = "mongodb://ipf-mongo:27017/ipf"
ods.security.oauth.enabled = false
application.write.url = "http://localhost:8080"
ipf.processing-data.ingress.transport = http

Al ejecutarse, la ipf-developer-app escuchará datos en el puerto 8081. Este puerto también se expondrá a la máquina host. Los logs se exportarán a logs/ipf-developer.app-log relativo al archivo de docker.

Utilizar la aplicación sin Docker

Prerrequisitos

Para ejecutar esta app se requiere:

  • Un runtime de Java 17

  • Una base de datos MongoDB

Configuración

La configuración puede sobrescribirse mediante el archivo application.conf, ubicado en el directorio config.

Propiedad

Descripción

Valor de ejemplo

ipf.mongodb.url

Define la URL de mongodb que debe usar la aplicación de desarrollador.

"mongodb://ipf-mongo:27017/ipf"

application.write.url

Define el host y puerto en el que la aplicación principal de IPF expondrá su servicio de consultas

localhost:8080

server.port

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

8081

Descarga

La ipf-developer-app está disponible aquí:

nexus.ipf.iconsolutions.com/repository/ipf-releases/com/iconsolutions/ipf/developer/ipf-developer-app/2.1.2/ipf-developer-app-2.1.2-runnable.jar

Debes elegir y descargar una versión de ipf-developer-app que sea compatible con la versión de IPF que estés usando. Revisa y sustituye los números de versión basándote en la documentación de versiones de IPF y/o los detalles de tu entorno objetivo.

Ejecución

Una vez descargada, colócala en este directorio y ejecuta (sustituyendo la versión que uses):

 java -cp "ipf-developer-app-2.1.2.jar:config" -D"ma.glasnost.orika.writeClassFiles"=false -D"ma.glasnost.orika.writeSourceFiles"=false -D"config.override_with_env_vars"=true -D"loader.main"="com.iconsolutions.ipf.developer.app.IpfDeveloperApplication" "org.springframework.boot.loader.launch.PropertiesLauncher"

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

localhost:8081/explorer.html

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