Cómo Ejecutar Aplicaciones IPF Independientes

IPF applicationsse crean todos con 2 perfiles de maven:

  • container- Genera contenedores de docker

  • runnable- Genera un archivo jar ejecutable para funcionar como una aplicación independiente.

Este documento se centra en cómo ejecutar IPF applications como aplicaciones independientes utilizando los archivos jar ejecutables generados a partir del perfil runnable.

Dónde descargar JARs ejecutables

Todas las aplicaciones que IPF produce se envían a ipf-lanzamientos en Nexus. Los archivos jar ejecutables estarán disponibles como un artefacto con el sufijo runnable en el repositorio de Nexus para cada versión de la aplicación que necesite. Por ejemplo, si desea obtener la ODS ingestión runnable jar para la versión 2.1.2 lo encontrará en este enlace:https://nexus.ipf.iconsolutions.com/repository/ipf-releases/com/iconsolutions/ipf/ods/ods-ingestion-app/2.1.2/ods-ingestion-app-2.1.2-runnable.jar

Cómo Generar Jars Ejecutables

Al construir un IPF application utilizando el andamio, tanto el container como el runnable serán generados en el pom.xml.

Si desea generar el runnable, deberá invocar el perfil runnable de la siguiente manera:

mvn clean install -P runnable

Cómo ejecutar JARs ejecutables

Todos los archivos JAR ejecutables de IPF se producen como Spring Boot aplicaciones. Para ejecutar un IPF application, tomando el ODS ingestión jar anterior como ejemplo, usted debe ejecutar lo siguiente:

java -cp ods-ingestion-app-2.1.2-runnable.jar:config -Dconfig.override_with_env_vars=true -Dloader.main=com.iconsolutions.ipf.ods. OdsIngestionApplication org.springframework.boot.loader.launch. PropertiesLauncher
Si está utilizando Windows, necesitamos reemplazar el primero `:` con un `;` - por ejemplo,`ods-ingestion-app-2.1.2-runnable.jar;config`

Si usted está sobrescribiendo alguna de la configuración predeterminada para las aplicaciones, entonces, en este ejemplo, el archivo de configuración para la aplicación,application.conf, viviría en la carpeta de configuración como se define en :config. Luego aprovechamos el Spring Boot_Properties Launcher_ para cargar las propiedades en la aplicación.

Añadiendo Métricas de Conector a Jars Ejecutables

Actualmente, nuestras imágenes de docker ya están instrumentadas con el archivo jar del agente cinnamon para la generación de informes de métricas del conector. Esto no fue posible al producir el archivo jar ejecutable, ya que no tenemos control sobre el despliegue, que depende del cliente. Más información sobre las métricas del conector está disponible.aquí.

Para habilitar las métricas de cinnamon en los archivos jar ejecutables, usted debe descargar la versión correcta del archivo jar de cinnamon. La versión correcta para descargar estará en el BOM bajo la propiedad cinnamon.version. El archivo jar también estará dentro del archivo jar ejecutable y se puede extraer del jar. Agregue el javaagent al ejecutar el programa en Java de la siguiente manera:

java -javaagent:/lib/cinnamon-agent-2.19.3.jar -cp ods-ingestion-app-2.1.2-runnable.jar:config -Dconfig.override_with_env_vars=true -Dloader.main=com.iconsolutions.ipf.ods. OdsIngestionApplication org.springframework.boot.loader.launch. PropertiesLauncher