Configurer Jenkins

Mise en place de l'environnement

Consultez la documentation Jenkins pour les étapes d'installation et de configuration générale.
Téléchargez et extrayez le fichier archive jenkins-pipeline.zip contenant ces fichiers : Talend_Simple_Pipeline.jenkins, maven_settings.xml et sample_pom.xml.
Installez la JDK Java 17, Apache Maven en version égale ou supérieure à 3.6.3 et Git bash.
Selon l'emplacement de publication de vos artefacts, configurez vos référentiels d'artefacts (Nexus, Artifactory) et votre compte Talend Cloud.

Prérequis techniques
Système d'exploitation	CPU (processeur)	RAM	Taille du disque SSD
Windows, Linux, Mac	4 cœurs ou équivalent	4 Go (minimum)	50 Go (minimum)

Installation de plug-ins Jenkins

Ajoutez les plug-ins nécessaires à l'exécution de vos pipelines sur le serveur Jenkins.

Dans Jenkins, allez dans Manage Jenkins > Managed files.
Cliquez sur l'onglet Available plugins pour voir les plug-ins disponibles.
Saisissez le nom des plug-ins suivants dans la barre de recherche et sélectionnez-les :
- Config File Provider (pour ajouter votre fichier de paramètres Maven personnalisés à Jenkins)
- Maven Integration
- Pipeline (ensemble d'outils pour la modélisation de pipelines de déploiement continu scriptés dans Jenkins)
- Pipeline Maven Integration
  Note InformationsRemarque : Plusieurs plug-ins, comme le plug-in Git, sont installés et activés par défaut.
Cliquez sur Install pour installer tous les plug-ins d'un coup, sans redémarrer le serveur Jenkins.

Configurer les chemins vers les outils Git et Maven

Stockez les variables d'environnement et les chemins vers des outils tiers dont votre pipeline Jenkins a besoin pour s'exécuter (Git, Maven).

Allez dans Manage Jenkins > Tools.
Dans la zone JDK installations (Installations de la JDK), ajoutez la JDK. Nommez-la JDK17 et configurez la variable JAVA_HOME pour qu'elle pointe vers le répertoire d'installation de votre JDK 17 .
Dans la zone Git installations (Installations de Git), vérifiez que Git est installé sous le nom Default et que le chemin pointe vers son exécutable.
Dans la zone Maven installations (Installations Maven), ajoutez l'outil Maven M3. Nommez-le Maven3 et configurez la variable MAVEN_HOME pour qu'elle pointe vers le répertoire d'installation Maven.
Cliquez sur Save pour que vos modifications soient prises en compte.

Stocker vos variables globales dans Jenkins

Accédez à Manage Jenkins (Gérer Jenkins) > System (Système).
Dans Global properties (Propriétés globales), sélectionnez Environment variables (Variables d'environnement) et ajoutez les variables suivantes, avec les valeurs correspondantes :
- Référentiel d'artefacts (Nexus/Artifactory)
  Exemple : Name (Nom) = REPO_URL ; Value (Valeur) = http://localhost:8081
- URL de publication vers Talend Cloud
  Nommez-la TMC_URL (cet identifiant sera utilisé dans le pipeline Jenkins) et ajoutez la valeur en fonction de votre région :
  - AWS Singapour : https://tmc.sg.cloud.talend.com/inventory
  - AWS USA : https://tmc.us.cloud.talend.com/inventory
  - AWS UE : https://tmc.eu.cloud.talend.com/inventory
  - AWS Asie-Pacifique : https://tmc.ap.cloud.talend.com/inventory
  - AWS Australie : https://tmc.au.cloud.talend.com/inventory
  - Azure USA Ouest : https://tmc.us-west.cloud.talend.com/inventory
Enregistrez vos modifications.

Stockez les identifiants de connexion de votre outil de gestion de contrôle des sources, de votre référentiel d'artefacts et de votre compte Talend Cloud dans Jenkins.

Allez dans Manage Jenkins (Gérer Jenkins) > Credentials (Identifiants).
Puis, cliquez sur System (Système) > Global credentials (Identifiants globaux) > Add Credentials (Ajouter des identifiants) et ajoutez les identifiants suivants :
- Identifiants Git : ils sont utilisés pour accéder au référentiel où sont stockés les éléments du projet (Jobs, Routes, Tests, etc.).
  Si vous utilisez vos jetons d'accès personnel Git, sélectionnez Username with password. Si vous utilisez le SSH, sélectionnez SSH username with private key dans la liste.
  
  Nommez son ID git_talend (cet identifiant sera utilisé dans le pipeline Jenkins) et ajoutez un commentaire, par exemple 'Git credentials for Talend repositories'.
  
  Cliquez sur Create (Créer) pour que vos modifications soient prises en compte.
- Identifiants du référentiel d'artefacts (Nexus ou Artifactory) : ils sont utilisés pour accéder aux référentiels où sont stockés vos bibliothèques, plug-ins et artefacts.
  Nommez son ID artifact_repo et ajoutez un commentaire, par exemple 'Artifact repository credentials for Talend repositories'.
  
  Cliquez sur Create (Créer) pour que vos modifications soient prises en compte.
- Jeton d'accès personnel Talend Management Console : il est utilisé pour accéder à votre compte Talend Cloud.
  Sélectionnez l'option Secret text (Texte secret) et configurez le jeton Talend Management Console de l'utilisateur·trice responsable de la publication vers Talend Cloud.
  
  Nommez son ID tmc_token et ajoutez un commentaire, par exemple 'TMC token'.
  
  Cliquez sur Create pour que vos modifications soient prises en compte.

Stocker vos fichiers de configuration dans Jenkins

Avant de stocker vos fichiers de configuration dans Jenkins, assurez-vous d'avoir extrait ces fichiers de l'archive jenkins_pipeline.zip : sample_pom.xml et maven_settings.xml.

Ces fichiers seront référencés dans la configuration de votre pipeline Jenkins.

Fichier POM d'exemple :

Dans Jenkins, naviguez vers Manage Jenkins (Gérer Jenkins) > Managed files (Fichiers gérés).
Cliquez sur Add a new Config (Ajouter une nouvelle configuration) et sélectionnez Simple XML file (Fichier XML simple) pour ajouter le fichier POM d'exemple.
Donnez-lui un nom et un ID, par exemple sample_pom et cliquez sur Next (Suivant). Cet ID sera utilisé plus tard dans le pipeline Jenkins.
Dans l'éditeur Content (Contenu), configurez le nom à sample_pomet collez le contenu du fichier sample_pom.xml précédemment téléchargé.
Cliquez sur Submit (Soumettre).

Fichier des paramètres Maven :

Dans Jenkins, naviguez vers Manage Jenkins (Gérer Jenkins) > Managed files (Fichiers gérés).
Cliquez à nouveau sur Add a new Config (Ajouter une nouvelle configuration) et sélectionnez Maven settings (Paramètres Maven) pour ajouter le fichier de configuration Maven.
Modifiez le fichier maven_settings.xml avec vos valeurs pour les paramètres <username>, <password> et <url>.
Note InformationsConseil : Dans Jenkins, vous pouvez remplacer les valeurs codées en dur de l'identifiant, du mot de passe et de l'URL du référentiel d'artefacts par les paramètres Jenkins, comme ${my_parameter}.
Donnez-lui un nom et un ID, maven_settings. Cet ID sera utilisé plus tard dans le pipeline Jenkins.
Dans l'éditeur Content (Contenu), collez le contenu du fichier maven_settings.xml modifié.
Cliquez sur Submit (Soumettre).

Fichier de licence :

Récupérez votre fichier de licence Talend envoyé par e-mail ou disponible dans le dossier d'installation du Studio Talend précédemment configuré.
Dans Jenkins, naviguez vers Manage Jenkins (Gérer Jenkins) > Managed files (Fichiers gérés).
Cliquez sur Add a new Config (Ajouter une nouvelle configuration) et sélectionnez Custom file (Fichier personnalisé) pour ajouter le fichier de licence Talend.
Donnez-lui un nom et un ID, par exemple talend_license et cliquez sur Next (Suivant). Cet ID sera utilisé plus tard dans le pipeline Jenkins.
Dans l'éditeur Content, collez le contenu du fichier Groovy et cliquez sur Submit.
Cliquez sur Add a new Config (Ajouter une nouvelle configuration) et sélectionnez Custom file (Fichier personnalisé) pour ajouter votre fichier de licence Talend.
Dans l'éditeur Content (Contenu), configurez le nom à talend_license et collez le contenu du fichier de licence (license).
Cliquez sur Submit (Soumettre).