Exécuter une Route de microservice - Cloud - 8.0

Cette section vous présente comment exécuter une Route construite en tant que microservice basé Spring-boot.

Pour exécuter une Route exportée en tant que fichier .jar, procédez comme suit, dans une invite de commande :

1. Modifiez le répertoire où le fichier .jar du microservice est situé.

2. Lancez la commande suivante. Pour plus d'informations concernant les propriétés de Spring Boot, consultez le site http://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html (en anglais). Notez que toutes les propriétés listées dans la page Web ne sont pas applicables au microservice ESB. Elles dépendent d'abord des fonctionnalités de Talend , mais également des Routes que vous construisez.

   java -jar <ArchiveFileName> --<SpringBootProperty>

   Par exemple, la commande suivante exécute un microservice nommé demoRoute.0.1.jar à l'aide d'une propriété d'environnement configurée dans le fichier Prod, où Prod est également le nom du contexte Talend . Ce paramètre doit être spécifié pour passer des propriétés de contexte à d'autres.

   java -jar demoRoute.0.1.jar --spring.config.location=classpath:config/contexts/ --spring.config.name=Prod

   Par défaut, lorsque vous exécutez la Route de microservice, elle appelle les fichiers de configuration du dossier /config dans le .jar du microservice. À l'aide de la propriété spring.config.additional-location, vous pouvez passer à un dossier de configuration externe dans lequel se situent les fichiers de configuration. Par exemple, la commande suivante exécute le microservice nommé demoRoute.0.1.jar, à l'aide des fichiers de configuration dans le dossier config, dans le répertoire où le .jar du microservice est situé.

   java -jar demoRoute.0.1.jar --spring.config.additional-location=./config

Plusieurs endpoints sont embarqués dans Spring Boot, vous permettant de monitorer et d'interagir avec le Microservice. Utilisez l'endpoint mappings afin d'afficher la liste des endpoints disponibles. Pour plus d'informations, consultez la documentation de Spring Boot (en anglais).

Pour exécuter une Route exportée en tant que fichier .zip, procédez comme suit :

1. Extrayez le fichier .zip dans le répertoire de votre choix.

2. Allez dans le dossier <RouteName> contenant le dossier externe config, le fichier du microservice .jar et les scripts de démarrage afin de démarrer le microservice pour Linux (.sh) et Windows (.bat).

3. Modifiez les fichiers de configuration dans le dossier config selon vos besoins et exécutez le fichier .sh sous Linux ou .bat sous Windows, pour démarrer le microservice avec les configurations externes.

Les microservices construits avec le Studio Talend fournissent l'accès aux endpoints Spring Boot Actuator.

Si vous avez installé la mie à jour mensuelle R2022-04 du Studio ou une mise à jour plus récente fournie par Talend, les endpoints de monitoring par défaut sont limités : info, health et jolokia.

Si vous avez installé la mise à jour mensuelle R2022-09 du Studio ou une mise à jour plus récente fournie par Talend, l'authentification basique est toujours activée pour atteindre les endpoints de gestion des microservices (info, health et jolokia).

Vous devez configurer les variables d'environnement SPRING_BOOT_SECURITY_USER_NAME et SPRING_BOOT_SECURITY_USER_PASSWORD sur la machine où sera exécuté le microservice.

Au démarrage du microservice, une entrée de log s'affiche lorsque les identifiants ont été trouvés.

Si aucune variable d'environnement n'est trouvée lors de l'exécution, un mécanisme va générer un mot de passe aléatoire au démarrage du microservice et enregistrer dans le log les avertissements correspondants.

Il vous est demandé de vous connecter avec les identifiants de sécurité pour accéder aux endpoints de gestion des microservices.

docker run -p 8065:8065 -t --env SPRING_BOOT_SECURITY_USER_NAME='user' --env SPRING_BOOT_SECURITY_USER_PASSWORD='password'  p1/docker_ms_demorestroute