Construire un Job de service de données en tant que microservice Spring Boot (déprécié) - Cloud - 8.0

Guide d'utilisation du Studio Talend

Version
Cloud
8.0
Language
Français
Product
Talend Big Data
Talend Big Data Platform
Talend Cloud
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Studio Talend
Content
Création et développement
Last publication date
2024-03-06
Disponible dans...

Cloud API Services Platform

Cloud Data Fabric

Data Fabric

Data Services Platform

ESB

MDM Platform

Real-Time Big Data Platform

Pourquoi et quand exécuter cette tâche

Dans la boîte de dialogue [Build Job], vous pouvez modifier le type de build afin de construire un Job de Services de données vers un Microservice ESB basé Spring Boot. Ce type de build est déprécié à partir de la version 8.0 R2024-02.
Avertissement : Seuls les Jobs qui incluent le composant tRESTRequest peuvent être construits en tant que microservice.

Procédure

  1. Cliquez sur Edit project properties (Modifier les propriétés du Projet) dans la barre d'outils du Studio Talend ou sélectionnez File (Fichier) > Edit Project Properties (Modifier les propriétés du Projet) dans la barre de menu pour ouvrir la boîte de dialogue Project Settings (Paramètres du projet).
    Configuration par défaut des microservices Spring Boot
  2. Dans l'arborescence à gauche, sélectionnez Build (Construction) > Spring Boot microservices (Microservices Spring Boot) > Default configuration (Configuration par défaut) pour afficher la vue correspondante et personnaliser la configuration du microservice Spring Boot selon vos besoins.
  3. Dans l'arborescence à gauche, sélectionnez Log4j pour afficher la vue correspondante.
    Configuration de Log4j
  4. Personnalisez la configuration de Log4j selon vos besoins. Les instructions Log4j XML par défaut écrivent uniquement les logs de type WARN dans la console.
    Un exemple de configuration Log4j est présenté ci-dessous et fournit également un fichier tesb.log lorsque le microservice ESB est démarré. Notez que la configuration de Log4j est la même pour le Studio Talend et le microservice ESB. Néanmoins, un fichier log4j.xml peut également être placé dans un dossier de configuration externe du microservice, lors de l'exécution, afin de fournir une configuration Log4j spécifique pour le déploiement en production.
    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
    <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
        <appender name="stdout" class="org.apache.log4j.ConsoleAppender">
            <layout class="org.apache.log4j.PatternLayout">
                <param name="ConversionPattern" value="%d | %-5.5p | %-16.16t | %-32.32C %4L | %m%n"/>
            </layout>
        </appender>
        <appender name="rollingFile" class="org.apache.log4j.RollingFileAppender">
            <param name="file" value="tesb.log"/>
            <param name="MaxFileSize" value="1024KB"/>
            <param name="MaxBackupIndex" value="10"/>
            <layout class="org.apache.log4j.PatternLayout">
                <param name="ConversionPattern" value="%d | %-5.5p | %-16.16t | %-32.32C %4L | %m%n"/>
            </layout>
        </appender>
        <root>
            <priority value="info"/>
            <appender-ref ref="stdout"/>
            <appender-ref ref="rollingFile"/>
        </root>
    </log4j:configuration>
  5. Dans le composant tRESTRequest du Job, vous devez utiliser des URL d'endpoints relatives et non absolues. Lorsque le microservice est en cours d'exécution, un conteneur Tomcat embarqué, avec le port par défaut 8065 est démarré par Spring-boot. Les services REST s'exécutent également sur ce port. Si vous souhaitez écraser le port par défaut, utilisez l'option --server.port dans la commande ou configurez-la dans le fichier application.properties du dossier /config, dans le .jar du microservice.
    Si un ou plusieurs services d'infrastructure ESB sont utilisés, vous devez effectuer les étapes suivantes avant de construire le Job :
    • Si Service Activity Monitoring est activé, modifiez le fichier <Studio_Home>/esb/agent.properties afin de configurer l'agent de Service Activity Monitoring selon vos besoins. Pour plus d'informations concernant les propriétés de agent.properties, consultez la section Service Activity Monitoring Agent configuration (en anglais).

    • Si Service Locator est activé, modifiez le fichier <Studio_Home>/esb/agent.properties afin de configurer le Service Locatorselon vos besoins. Pour plus d'informations concernant les propriétés de locator.properties, consultez Configuring the Service Locator (en anglais).

    • Si le Job est un fournisseur de service et que l'authentification par jeton utilisateur est activée, modifiez le fichier Studio_Home/esb/microservice/users.properties afin de spécifier les informations d'authentification de l'utilisateur ou de l'utilisatrice, en suivant le format <USERNAME>=<PASSWORD>. Par exemple, les paramètres suivants définissent deux utilisateurs ou utilisatrices :

      tadmin=tadmin
      tesb=tesb
    • Si l'authentification par jeton SAML et les autorisations sont activées, vous devez installer les artefacts d'entreprise ESB dans votre référentiel local Maven, à l'aide des commandes suivantes, dans une invite de commande :

      cd <TalendRuntimePath>/add-ons/maven-repo
      mvn clean package -s <Studio_Home>/configuration/maven_user_settings.xml
  6. Ouvrez le Job que vous souhaitez construire en tant que Microservice dans l'espace de modélisation graphique. Dans la vue Deployment (Déploiement) de l'onglet Job, sélectionnez Microservice (Spring Boot) dans la liste Build Type (Type de construction). Sauvegardez le Job.
    Vue Deployment (Déploiement) de l'onglet Job.
  7. Dans l'arborescence Repository, cliquez-droit sur le Job que vous voulez construire et sélectionnez Build Job pour ouvrir la boîte de dialogue Build Job.
    Boîte de dialogue Build Job (Construire le Job).
  8. Dans le champ To archive file, cliquez sur le bouton Browse et parcourez jusqu'au répertoire dans lequel vous souhaitez sauvegardez votre Job construit.
  9. Dans la zone Job Version, sélectionnez le numéro de version du Job que vous souhaitez construire si vous en avez créé plus d'une version.
  10. Dans la zone Build Type, sélectionnez Microservice Spring Boot.
  11. Dans la zone Options :
    • cochez la case Export as ZIP pour exporter la Route vers un fichier .zip, fournissant un dossier externe de configuration et démarrer les scripts afin de lancer le microservice avec le dossier de configuration externe pour Linux (.sh) et pour Windows (.bat). Si l'option n'est pas sélectionnée, le Job est exporté en tant que fichier .jar par défaut.

    • cochez la case Enable Prometheus metrics endpoint (Activer l'endpoint de métriques Prometheus) pour construire l'endpoint de métriques Prometheus dans le microservice, afin de monitorer l'exécution des Jobs, la mémoire de la JVM, la consommation du processeur etc. Par défaut, cette fonctionnalité est un pont entre tous les attributs JMX et les valeurs dans Prometheus. Pour plus d'informations concernant Prometheus, consultez la documentation Prometheus (en anglais).
  12. Cliquez sur Finish pour valider vos modifications, terminer l'export et fermer la boîte de dialogue. Une fenêtre s'ouvre, vous indiquant que Maven doit être configuré avec une connexion à Internet pour construire le microservice ESB, car certaines bibliothèques doivent être téléchargées depuis le référentiel Maven distant. Le Studio Talend nécessite une connexion à Internet lorsque vous utilisez la fonctionnalité ESB de microservice. Le Studio Talend ne fournit pas de mode complètement hors connexion pour l'opération de construction d'un microservice ESB. Cliquez sur Yes pour passer Maven en mode en ligne.
    Configurer Maven Online.
    Si l'opération Finish vous conduit à une erreur, vous pouvez trouver plus d'informations relatives à cette erreur dans le fichier de log du Studio Talend <Studio_Home>\workspace\.metadata\.log.

Résultats

Un fichier .jar ou .zip pour le Job est créé à l'emplacement défini. Vous pouvez l'exécuter indépendamment du Studio Talend en mode standalone. Pour plus d'informations concernant l'exécution de microservices, consultez Exécuter une Route construite en tant que microservice Spring Boot (déprécié).