Configuration du Job Pipeline dans Jenkins et exécution

Créer un nouveau Job de type "Pipeline" dans Jenkins

Maintenant que votre Jenkinsfile est rédigé et poussé sur votre dépôt Git, il est temps de configurer Jenkins pour qu'il l'utilise. La première étape consiste à créer un nouveau Job dans Jenkins, mais cette fois-ci, il sera de type "Pipeline".

Connectez-vous à votre interface Jenkins. Sur le tableau de bord, cliquez sur "Nouveau Item" (ou "New Item"). Donnez un nom à votre projet, par exemple MonPremierPipelineCI. Ensuite, parmi les types de projets proposés, sélectionnez "Pipeline". Contrairement au Job Freestyle, le type "Pipeline" est spécifiquement conçu pour exécuter des définitions de pipeline, notamment celles provenant d'un Jenkinsfile.

Après avoir nommé votre projet et sélectionné "Pipeline", cliquez sur "OK" ou "Valider". Vous serez redirigé vers la page de configuration de ce nouveau Job Pipeline. Vous remarquerez que cette page de configuration est nettement plus concise que celle d'un Job Freestyle, car l'essentiel de la logique est déporté dans le Jenkinsfile.

Configurer le Job pour utiliser le Jenkinsfile depuis Git (SCM)

Sur la page de configuration de votre Job Pipeline, faites défiler jusqu'à la section intitulée "Pipeline". C'est ici que vous allez indiquer à Jenkins comment obtenir la définition de votre pipeline. Plusieurs options sont disponibles dans le menu déroulant "Définition" (ou "Definition"). Pour notre cas, nous voulons que Jenkins récupère le Jenkinsfile depuis notre dépôt Git. Sélectionnez donc l'option "Pipeline script from SCM" (Script de pipeline depuis un SCM).

Une fois "Pipeline script from SCM" sélectionné, de nouvelles options apparaissent. Dans la section "SCM", choisissez "Git" dans le menu déroulant. Un champ "Repository URL" (URL du dépôt) s'affiche. C'est ici que vous devez coller l'URL de votre dépôt Git où se trouvent votre index.html et votre Jenkinsfile (par exemple, https://github.com/votreNom/votreDepot.git).

Si votre dépôt est privé, vous devrez également spécifier les "Credentials" (Identifiants) appropriés. Jenkins propose un gestionnaire d'identifiants sécurisé pour stocker vos clés SSH ou vos tokens d'accès. Si votre dépôt est public, vous pouvez laisser ce champ sur "Aucun" ou la valeur par défaut.

Plus bas, dans la section "Script Path" (Chemin du script), assurez-vous que la valeur est bien Jenkinsfile. C'est le nom par défaut du fichier que Jenkins cherchera à la racine de votre dépôt. Si vous aviez nommé votre fichier différemment ou placé dans un sous-répertoire, vous devriez ajuster ce chemin en conséquence. Pour notre projet, Jenkinsfile à la racine est correct.

Une fois ces paramètres configurés (Définition : Pipeline script from SCM, SCM : Git, URL du dépôt, et chemin du script : Jenkinsfile), cliquez sur "Sauvegarder" (ou "Save") en bas de la page.

Lancer l'exécution du Pipeline et suivre sa progression

Après avoir sauvegardé la configuration, vous êtes redirigé vers la page principale de votre Job Pipeline MonPremierPipelineCI. Comme pour le Job Freestyle, vous trouverez une option "Lancer un build" (ou "Build Now") dans le menu de gauche. Cliquez dessus pour démarrer votre premier pipeline !

Une nouvelle exécution apparaîtra dans l'"Historique des builds". Cliquez sur le numéro de ce build (probablement #1) pour accéder à sa page de détails. La présentation est un peu différente de celle d'un Job Freestyle. Vous devriez voir une visualisation des étapes (stages) de votre pipeline telles que définies dans votre Jenkinsfile : "Checkout SCM", "Simulate Build", et "Simulate Test".

Chaque étape passera par différents états (en cours, succès, échec) au fur et à mesure de l'exécution. Vous pouvez cliquer sur une étape spécifique pour voir ses logs. Pour une vue d'ensemble des logs de tout le pipeline, l'option "Console Output" (Sortie de la console) reste disponible et est toujours aussi cruciale.

Vérifier le résultat et analyser les logs des étapes

Consultez la "Sortie de la console" ou les logs de chaque étape. Vous devriez y retrouver les messages echo que vous avez placés dans votre Jenkinsfile, ainsi que la sortie des commandes sh (comme le ls -la ou la vérification de l'existence d'index.html).

Vérifiez que chaque étape s'est déroulée comme prévu :

• Checkout SCM : Le code a-t-il été cloné sans erreur ? Y a-t-il des messages indiquant une connexion réussie au dépôt Git ?
• Simulate Build : La commande ls -la a-t-elle affiché index.html et Jenkinsfile ? Les messages "Début de la simulation de construction..." et "Simulation de construction terminée." sont-ils présents ?
• Simulate Test : Le message "Le fichier index.html existe." (ou une erreur si ce n'est pas le cas) est-il affiché ? Les messages de début et de fin de simulation de test sont-ils là ?
• Post-actions : Les messages de la section post (comme "Pipeline terminé." et "Le pipeline a réussi !") sont-ils visibles à la fin des logs ?

Si toutes les étapes sont vertes (succès) et que les logs confirment le bon déroulement des opérations, félicitations ! Vous venez de configurer et d'exécuter avec succès votre premier pipeline Jenkins défini via un Jenkinsfile récupéré depuis Git. Vous avez franchi une étape majeure dans la maîtrise de Jenkins et du "Pipeline as Code". Cette base solide vous permettra d'aborder des pipelines bien plus complexes et des scénarios d'automatisation CI/CD avancés.