Création d'un Job de type "Pipeline"

Le job Pipeline : le conteneur de votre automatisation Jenkins

Dans Jenkins, un "Job" (ou "Projet") est l'unité de travail fondamentale. C'est une tâche configurable que Jenkins exécute, comme compiler du code, exécuter des tests, déployer une application, etc. Parmi les différents types de jobs disponibles, le type Pipeline est le plus puissant et le plus flexible pour implémenter des workflows d'intégration et de déploiement continus (CI/CD) complexes.

Un job de type Pipeline est spécifiquement conçu pour exécuter un Jenkinsfile. Comme nous l'avons vu, le Jenkinsfile est un script qui définit l'ensemble du processus d'automatisation en utilisant la syntaxe Pipeline (Déclarative ou Scripted). Créer un job Pipeline est donc la première étape concrète pour mettre en oeuvre l'approche "Pipeline as Code". Ce job devient le point d'entrée pour Jenkins pour lire et exécuter les instructions contenues dans votre Jenkinsfile.

L'avantage principal de ce type de job est qu'il délègue la logique du pipeline au Jenkinsfile lui-même, qui est versionné avec votre code source. Cela rend la configuration du job dans l'interface Jenkins relativement simple, car la complexité est gérée dans le code du pipeline. Cela favorise la reproductibilité, la collaboration et la maintenabilité de vos processus d'automatisation.

Guide étape par étape pour créer votre premier job Pipeline

La création d'un job de type Pipeline dans Jenkins est un processus simple qui se déroule via l'interface utilisateur. Voici les étapes détaillées pour y parvenir :

1. Accéder à la page d'accueil de Jenkins : Connectez-vous à votre instance Jenkins. Vous devriez voir le tableau de bord principal.
2. Démarrer la création d'un nouveau job : Sur le côté gauche du tableau de bord, cliquez sur le lien "Nouveau Projet" (ou "New Item" en anglais). Si votre interface est différente, cherchez une option similaire permettant de créer un nouveau job.
3. Nommer votre job et choisir le type :
   a. Dans le champ "Enter an item name" (ou "Saisir un nom d'item"), donnez un nom descriptif à votre pipeline. Par exemple : Mon-Application-CI-Pipeline, Frontend-Build-And-Test. Il est conseillé d'utiliser des noms clairs et d'éviter les espaces (utilisez des tirets ou la casse CamelCase).
   b. Parmi la liste des types de projets proposés, sélectionnez "Pipeline". C'est ce choix qui indique à Jenkins que ce job sera défini par un script Jenkinsfile.
   c. Cliquez sur le bouton "OK" en bas de la page.

Après avoir cliqué sur "OK", vous serez redirigé vers la page de configuration de votre nouveau job Pipeline. C'est ici que vous allez indiquer à Jenkins comment trouver et exécuter votre Jenkinsfile.

Configuration de la source du script Pipeline

Sur la page de configuration du job Pipeline, faites défiler jusqu'à la section intitulée "Pipeline". C'est la section la plus importante pour ce type de job. Vous y trouverez un menu déroulant "Definition" qui propose plusieurs options pour spécifier d'où provient le script Jenkinsfile :

• Pipeline script :
  Cette option vous permet de saisir ou de coller votre script Jenkinsfile directement dans une zone de texte multiligne fournie dans l'interface Jenkins. C'est une méthode pratique pour :
  • Tester rapidement des petits scripts.
  • Créer des pipelines très simples qui n'ont pas besoin d'être versionnés avec le code source de l'application.
  • Apprendre la syntaxe du Jenkinsfile sans avoir à gérer un dépôt Git au début.
  Cependant, pour des pipelines de production ou des projets collaboratifs, cette approche est moins recommandée car le pipeline n'est pas versionné et est dissocié du code source.
• Pipeline script from SCM (Source Code Management) :
  C'est l'option fortement recommandée pour la plupart des cas d'usage. Elle permet à Jenkins de récupérer le Jenkinsfile directement depuis votre système de gestion de code source (par exemple, Git, Subversion). Pour configurer cette option :
  1. Sélectionnez "Pipeline script from SCM" dans le menu déroulant "Definition".
  2. Une nouvelle section "SCM" apparaît. Choisissez votre type de SCM (généralement "Git").
  3. Repository URL : Entrez l'URL de votre dépôt Git où se trouve le code de votre application ET votre fichier Jenkinsfile. Par exemple, https://github.com/votre-utilisateur/votre-projet.git.
  4. Credentials : Si votre dépôt Git est privé, sélectionnez les identifiants (par exemple, nom d'utilisateur/mot de passe, clé SSH, token d'accès) préalablement configurés dans Jenkins qui permettent d'accéder au dépôt. Si le dépôt est public, vous pouvez généralement laisser "None".
  5. Branches to build : Spécifiez la ou les branches que Jenkins doit surveiller et utiliser pour trouver le Jenkinsfile. Par exemple, */main, */develop, ou laissez vide pour toutes les branches (Jenkins essaiera de trouver un Jenkinsfile dans la branche par défaut lors du premier build manuel). Vous pouvez utiliser des wildcards.
  6. Repository browser : (Optionnel) Vous pouvez configurer un navigateur de dépôt (comme GitHubWeb) pour faciliter les liens vers le SCM depuis l'interface Jenkins.
  7. Script Path : C'est le chemin d'accès à votre fichier Jenkinsfile à l'intérieur de votre dépôt. Par défaut, Jenkins s'attend à trouver un fichier nommé Jenkinsfile à la racine du dépôt. Si votre fichier a un autre nom ou se trouve dans un sous-répertoire, spécifiez-le ici (par exemple, ci/MonPipeline.groovy).

D'autres options de configuration sont disponibles sur la page du job, comme les paramètres de build (Build Triggers), les options de conservation des builds (Discard old builds), etc. Pour un premier pipeline simple, la configuration de la section "Pipeline" est souvent suffisante pour commencer.

Une fois que vous avez configuré la source de votre script Pipeline, n'oubliez pas de cliquer sur "Sauvegarder" (ou "Save") en bas de la page de configuration. Votre job Pipeline est maintenant créé et prêt à être exécuté ! Vous pouvez le lancer manuellement en cliquant sur "Lancer un build" (ou "Build Now") depuis la page du job.