Cómo Ejecutar de Forma Independiente IPF Applications

IPF applications están todos creados con 2 maven perfiles:

  • contenedor- Genera docker contenedores

  • 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 el ODS ingestion el archivo jar ejecutable 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 usando el scaffolder los proyectos tanto el container como el runnable se generarán 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 ingestion jar arriba como un 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
[SUGERENCIA]
====
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, nuestro docker Las imágenes ya están instrumentadas con el archivo jar del agente de canela para la generación de informes de métricas del conector. Esto no fue posible al producir el archivo jar ejecutable, ya que no estamos en control del despliegue, lo cual 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 puede ser extraído del jar. Agregue el javaagent al ejecutar el java programa como sigue:

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