UTILS1 - Aplicación para Desarrolladores de IPF

Este documento cubre cómo utilizar la aplicación ipf-developer-app. Hay dos enfoques recomendados para el tutorial, tanto con docker como sin docker. Analicemos estos:

Uso de la Aplicación A Través de Docker

A continuación se proporciona una entrada simple de archivo docker para la aplicación del 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 application.conf archivo dentro de un directorio de configuración relativo a la entrada de docker mencionada anteriormente. 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

Cuando se ejecute la aplicación ipf-developer-app, escuchará datos en el puerto 8081. Este puerto también será expuesto a la máquina host. Los registros serán exportados a logs/ipf-developer.app-log relativo al archivo docker.

Usando la Aplicación Sin Docker

Requisitos previos

Para ejecutar esta aplicación se requiere:

  • A Java 17 tiempo de ejecución

  • A MongoDB base de datos

Configuración

La configuración puede ser anulada a través de la application.conf archivo ubicado en el directorio de configuración.

Propiedad

Descripción

Valor de Ejemplo

ipf.mongodb.url

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

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

application.write.url

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

localhost:8080

server.port

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

8081

Descargar

La aplicación ipf-developer-app está disponible aquí:

[_note_about_versions]

Debe elegir y descargar una versión de la ipf-developer-app *que sea compatible con la versión de IPF que está utilizando*. Por favor, verifique y reemplace los números de versión según el xref:reference::release/releases.adoc[Documentación de liberación de IPF] y/o los detalles para su entorno objetivo.

Ejecutando

Una vez descargado, colóquelo en este directorio y ejecute (reemplazando la versión que está utilizando):

 java -cp "ipf-developer-app-2.1.2.jar:config" -D"ma.glasnost.orika.writeClass Files"=false -D"ma.glasnost.orika.writeSource Files"=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 a partir de:

NOTE Tenga en cuenta que en Windows, el dos puntos en el comando de ejecución debe ser reemplazado por un punto y coma.