Exploration de l'interface Jenkins

Introduction

Bienvenue dans votre première expérience pratique avec Jenkins. Jenkins est un serveur d'automatisation puissant et open-source utilisé pour la construction, le test et le déploiement de logiciels, une pratique connue sous le nom d'Intégration Continue et de Déploiement Continu (CI/CD).

Dans ce laboratoire, vous vous familiariserez avec les aspects fondamentaux de l'interface utilisateur de Jenkins. Nous vous guiderons à travers le tableau de bord principal, vous montrerons comment créer et configurer votre premier projet simple, lancer une construction (build) et inspecter les résultats. Le service Jenkins est déjà installé et en cours d'exécution dans cet environnement, vous pouvez donc vous concentrer directement sur l'exploration de ses fonctionnalités.

À la fin de ce laboratoire, vous serez capable de :

• Naviguer sur le tableau de bord principal de Jenkins.
• Créer un nouveau projet Freestyle.
• Lancer manuellement un job de construction (build).
• Afficher l'historique des constructions (build history) et la sortie de la console (console output).

Commençons.

Accès et exploration du tableau de bord Jenkins

Dans cette étape, vous vous connecterez à l'interface web de Jenkins et vous familiariserez avec le tableau de bord principal. Le service Jenkins est déjà en cours d'exécution dans un conteneur pour vous.

Tout d'abord, accédez à l'interface web de Jenkins. En haut de votre écran LabEx, cliquez sur l'onglet Desktop Interface. À l'intérieur du bureau virtuel, ouvrez le navigateur web Firefox. Le navigateur s'ouvrira automatiquement sur http://localhost:8080, vous n'avez donc pas besoin de saisir manuellement l'URL. Aucune connexion n'est requise.

Vous verrez le tableau de bord principal de Jenkins. Prenez un moment pour examiner ses composants clés :

• Barre de Navigation Latérale (Gauche) : C'est votre menu de navigation principal. Vous y trouverez des liens importants tels que New Item (pour créer de nouveaux jobs) et Build History (une vue globale de toutes les constructions).
• Zone de Contenu Principale : Cette zone affiche une liste de tous les jobs que vous avez créés. Initialement, elle sera vide.

Maintenant que vous êtes familiarisé avec le tableau de bord, vous êtes prêt à créer votre premier projet.

Création d'un projet Freestyle

Dans cette étape, vous allez créer votre premier job Jenkins en utilisant le type "Projet Freestyle" (Freestyle project). Un projet Freestyle est une option très flexible et facile à utiliser, parfaite pour les débutants et une grande variété de tâches d'automatisation.

1. Dans l'interface web de Jenkins, cliquez sur Nouveau Projet (New Item) dans la barre de navigation latérale gauche.

2. Sur la page suivante, vous devez fournir un nom pour votre projet et sélectionner son type.

   • Dans le champ Entrez un nom d'élément (Enter an item name), tapez My-First-Job.
   • Sélectionnez Projet Freestyle (Freestyle project) dans la liste des options.
   • Cliquez sur le bouton OK en bas.

3. Vous serez maintenant sur la page de configuration du projet. C'est ici que vous définissez ce que votre job va exécuter. Pour ce laboratoire, nous allons ajouter une seule étape de construction simple. Faites défiler jusqu'à la section Étapes de construction (Build Steps).

4. Cliquez sur le bouton déroulant Ajouter une étape de construction (Add build step) et sélectionnez Exécuter le shell (Execute shell). Cela vous permet d'exécuter des commandes shell dans le cadre de votre construction (build).

5. Une boîte de commande apparaîtra. Dans cette boîte, tapez la commande suivante :

   echo "Hello from my first Jenkins job!"

6. Enfin, faites défiler jusqu'au bas de la page et cliquez sur le bouton Enregistrer (Save).

Après l'enregistrement, Jenkins vous redirigera vers la page principale de votre projet nouvellement créé, My-First-Job.

Exécution du job de build

Dans cette étape, vous allez exécuter, ou "construire" (build), la tâche que vous venez de créer. Exécuter une tâche signifie lancer les étapes que vous avez configurées pour celle-ci.

Vous devriez actuellement vous trouver sur la page du projet My-First-Job. Si vous avez navigué ailleurs, vous pouvez y revenir en cliquant sur son nom dans le tableau de bord principal de Jenkins.

1. Sur la page du projet My-First-Job, regardez la barre de navigation latérale à gauche. Vous verrez une option appelée Build Now (Construire Maintenant).

2. Cliquez sur Build Now pour démarrer le processus de construction.

Une fois que vous cliquez, une nouvelle construction sera planifiée. Vous la verrez apparaître sous la section Build History (Historique des Constructions) en bas à gauche. La construction se verra attribuer un numéro, commençant par #1.

Une petite icône de statut apparaît à côté du numéro de construction. Une icône verte clignotante signifie que la construction est en cours. Un cercle vert plein signifie que la construction a réussi. Étant donné que notre tâche est très simple, elle se terminera en une ou deux secondes.

Vous avez maintenant déclenché avec succès votre première construction.

Affichage de la sortie de la console

Dans cette étape, vous apprendrez comment vérifier les résultats de votre construction (build). Examiner la sortie est une partie essentielle de tout processus d'automatisation, car cela vous indique exactement ce qui s'est passé et si cela a réussi.

1. Sur la page du projet My-First-Job, regardez la section Historique des constructions (Build History) dans le coin inférieur gauche. Vous devriez voir votre première construction, étiquetée #1, avec un cercle vert indiquant le succès.

2. Cliquez sur le numéro de construction #1 pour accéder à la page de détails de cette construction spécifique.

3. Sur la page de construction, vous verrez divers détails concernant la construction, comme le moment où elle a été exécutée. Le lien le plus important ici pour le débogage est Sortie Console (Console Output). Cliquez sur Console Output dans la barre latérale gauche.

4. La page de Sortie Console affiche un journal détaillé de chaque action effectuée par Jenkins pendant la construction. Vous verrez que Jenkins a démarré la construction, exécuté votre commande shell, puis marqué la construction comme terminée.

La sortie devrait ressembler à ceci :

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

Comme vous pouvez le constater, le journal inclut la commande echo que nous avons configurée et sa sortie : Hello from my first Jenkins job!. Le statut final Finished: SUCCESS confirme que le travail (job) s'est exécuté sans aucune erreur.

Résumé

Félicitations pour avoir terminé ce laboratoire d'introduction. Vous avez franchi avec succès vos premiers pas dans le monde de Jenkins.

Dans ce laboratoire, vous avez appris à :

• Accéder au tableau de bord Jenkins et identifier ses composants clés.
• Créer un nouveau projet Freestyle à partir de zéro.
• Configurer une étape de construction simple "Execute shell".
• Déclencher manuellement une construction pour votre projet.
• Trouver et inspecter l'historique des constructions et la sortie de console détaillée pour vérifier le résultat.

Ces compétences fondamentales sont les éléments constitutifs pour créer des pipelines d'automatisation plus complexes et plus puissants. Vous êtes maintenant bien préparé pour explorer des fonctionnalités Jenkins plus avancées.