Projet 1 - Mon premier Job Freestyle "Hello Jenkins"

Introduction et objectifs du projet "Hello Jenkins"

Bienvenue dans votre première incursion pratique avec Jenkins ! Le projet "Hello Jenkins" est un rite de passage classique, conçu pour vous familiariser avec les mécanismes fondamentaux de cet outil puissant. Bien que simple en apparence, il constitue une étape cruciale pour bâtir votre confiance et votre compréhension de l'automatisation. Ce projet vous permettra de toucher du doigt la création et l'exécution d'une tâche automatisée, le point de départ de toute chaîne CI/CD.

L'objectif principal de ce premier projet est de vous guider à travers le processus de création d'un "Job Freestyle". Vous apprendrez concrètement à : naviguer dans l'interface utilisateur de Jenkins pour créer un nouveau projet, configurer des paramètres de base, ajouter une étape d'exécution de script simple (un script shell dans notre cas), lancer manuellement ce Job, et enfin, vérifier son exécution en consultant les journaux (logs) générés. C'est une excellente façon de découvrir le cycle de vie d'un Job Jenkins.

A l'issue de ce projet, vous serez capable de créer de manière autonome un Job Freestyle simple, d'y insérer des commandes basiques et d'interpréter les résultats de son exécution. Cette compétence initiale est indispensable avant d'aborder des concepts plus avancés tels que les pipelines, la gestion des sources ou l'intégration d'outils plus complexes. Considérez cela comme la pose de la première brique de votre édifice de compétences Jenkins.

Configuration détaillée de votre Job Freestyle "Hello Jenkins"

Pour commencer, accédez à votre interface Jenkins. Une fois connecté, le tableau de bord principal s'affiche. Recherchez l'option permettant de créer un nouveau Job. Elle est généralement bien visible sur la page d'accueil ou dans le menu de gauche, souvent intitulée "Nouveau Item" ou "Créer un item".

Cliquez sur "Nouveau Item". Jenkins vous demandera alors de donner un nom à votre projet. Choisissez un nom descriptif, par exemple : Hello-Jenkins-Freestyle. Ensuite, vous devrez sélectionner le type de projet. Pour cet exercice, sélectionnez l'option "Projet Freestyle" (ou "Freestyle project"). C'est le type de Job le plus simple et le plus flexible pour débuter, idéal pour des tâches scriptées ou des configurations qui ne nécessitent pas la complexité d'un pipeline. Une fois le nom saisi et le type sélectionné, cliquez sur "OK" ou "Valider" pour passer à la page de configuration.

Vous êtes maintenant sur la page de configuration de votre Job "Hello-Jenkins-Freestyle". Cette page est divisée en plusieurs sections. La première, "Général", vous permet d'ajouter une description à votre projet, ce qui est une bonne pratique pour documenter vos Jobs. Pour l'instant, une description simple comme "Mon premier Job Jenkins pour afficher Hello Jenkins" suffira. D'autres options plus avancées sont disponibles ici, mais nous les explorerons ultérieurement.

Faites défiler la page jusqu'à la section intitulée "Build" ou parfois "Etapes de build" (selon la version et la langue de votre Jenkins). C'est ici que la magie opère ! Cette section vous permet de définir les actions concrètes que Jenkins doit effectuer lorsque le Job est exécuté. Pour notre projet "Hello Jenkins", nous allons ajouter une simple étape qui exécutera un script shell.

Ajout de l'étape de build : "Exécuter un script shell"

L'étape "Exécuter un script shell" (ou "Execute shell" si votre interface Jenkins est en anglais) est l'une des plus fondamentales et polyvalentes. Elle vous permet d'exécuter n'importe quelle commande ou script que vous pourriez taper dans un terminal Linux ou macOS (ou des commandes équivalentes dans un environnement Windows si vous utilisez l'étape "Exécuter une commande batch Windows"). C'est le moyen direct d'interagir avec le système d'exploitation de l'agent Jenkins qui exécutera le Job.

Dans la section "Build", cliquez sur le bouton déroulant "Ajouter une étape au build" (ou "Add build step"). Une liste d'options s'affichera. Recherchez et sélectionnez "Exécuter un script shell". Un champ de texte apparaîtra, intitulé "Commande" (ou "Command"). C'est dans ce champ que vous allez saisir les instructions que Jenkins doit exécuter.

Maintenant, saisissez le script suivant dans le champ "Commande". Ce script affichera un message de bienvenue, la date et l'heure actuelles, ainsi que le répertoire de travail courant du Job :

echo "Hello Jenkins! Bienvenue dans votre premier Job Freestyle."
echo "Nous sommes le : $(date)"
echo "Mon répertoire de travail actuel est : $(pwd)"
echo "Fin du script."

Analysons brièvement ce script :

• echo "..." : Cette commande affiche simplement le texte qui suit entre guillemets dans la sortie console du build.
• $(date) : Il s'agit d'une substitution de commande. La commande date est exécutée, et sa sortie (la date et l'heure actuelles) remplace $(date) dans la chaîne de caractères affichée par echo.
• $(pwd) : De même, pwd (print working directory) affiche le chemin absolu du répertoire où le script est exécuté par Jenkins.

Une fois votre script saisi, n'oubliez pas de cliquer sur le bouton "Sauvegarder" (ou "Save") en bas de la page de configuration. Votre premier Job Jenkins est maintenant configuré et prêt à être exécuté !

Exécution du Job et vérification minutieuse du résultat

Après avoir sauvegardé la configuration de votre Job "Hello-Jenkins-Freestyle", vous êtes redirigé vers la page principale de ce Job. Sur le côté gauche, vous devriez voir une option "Lancer un build" (ou "Build Now"). Cliquez dessus pour démarrer l'exécution de votre Job. C'est aussi simple que ça !

Dès que vous lancez le build, une nouvelle entrée apparaît dans la section "Historique des builds" (ou "Build History") sur la page du Job. Chaque exécution (ou "build") est numérotée séquentiellement (par exemple, #1, #2, etc.) et son état est indiqué par une icône (une sphère bleue pour succès, rouge pour échec, grise ou animée pendant l'exécution). Cliquez sur le numéro du build que vous venez de lancer (probablement #1) pour accéder à ses détails.

Sur la page du build spécifique, recherchez dans le menu de gauche l'option "Sortie de la console" (ou "Console Output"). C'est l'un des écrans les plus importants dans Jenkins, car il affiche tous les messages, commandes exécutées, erreurs et informations de débogage générés pendant l'exécution de votre Job. C'est votre principal outil pour comprendre ce qui s'est passé.

Examinez attentivement la sortie de la console. Vous devriez y retrouver les messages que vous avez demandés avec les commandes echo dans votre script shell. Vérifiez que le message "Hello Jenkins! Bienvenue dans votre premier Job Freestyle.", la date et l'heure, ainsi que le répertoire de travail sont bien affichés. Si tout s'est bien passé, la dernière ligne indiquera quelque chose comme "Finished: SUCCESS". Si vous voyez des messages d'erreur ou si le build est marqué comme échoué (icône rouge), relisez attentivement les messages dans la console pour identifier la cause. Les erreurs courantes à ce stade peuvent être des fautes de frappe dans les commandes.

Félicitations ! Si vous voyez vos messages s'afficher correctement et que le build est un succès, vous venez de créer, configurer et exécuter avec succès votre tout premier Job Jenkins. Cette première réussite est une étape importante qui démontre la simplicité avec laquelle on peut commencer à automatiser des tâches. Vous avez maintenant une base solide pour explorer des fonctionnalités plus avancées de Jenkins.