Exécution et vérification du résultat

Lancer manuellement le build de votre Job Freestyle

Une fois que vous avez configuré votre Job Freestyle et ajouté l'étape "Exécuter un script shell" avec les commandes souhaitées, l'étape suivante est de déclencher son exécution. Après avoir cliqué sur "Sauvegarder" sur la page de configuration, vous êtes normalement redirigé vers la page principale de ce Job. C'est à partir de cette page que vous pouvez lancer un build manuellement.

Sur la page de votre Job (par exemple, "Hello-Jenkins-Freestyle"), recherchez dans le menu de gauche une option intitulée "Lancer un build" (ou "Build Now" en anglais). Un simple clic sur ce lien suffit pour que Jenkins mette en file d'attente et exécute votre Job. Il n'y a généralement pas de confirmation demandée ; l'action est immédiate.

Dès que vous cliquez sur "Lancer un build", une nouvelle entrée apparaît dans la section "Historique des builds" (ou "Build History") de la page du Job. Cette section liste toutes les exécutions passées et en cours de ce Job. Chaque build est identifié par un numéro unique (commençant par #1 pour le premier build), une date, et une icône indiquant son état (par exemple, une sphère bleue clignotante ou grise pendant l'exécution, bleue fixe pour un succès, rouge pour un échec). Notez le numéro de votre build ; vous en aurez besoin pour consulter ses détails.

Consulter la sortie console pour analyser l'exécution

L'historique des builds vous donne un aperçu rapide de l'état de chaque exécution, mais pour comprendre réellement ce qui s'est passé, vous devez accéder à la "Sortie de la console" (ou "Console Output"). Cliquez sur le numéro du build que vous venez de lancer (par exemple, #1) dans l'historique des builds. Cela vous mènera à la page spécifique de ce build.

Sur la page du build, localisez et cliquez sur l'option "Sortie de la console" dans le menu de gauche. Cet écran est l'un des plus importants dans Jenkins. Il affiche en temps réel (si le build est en cours) ou intégralement (si le build est terminé) tous les messages générés par Jenkins et par votre script pendant son exécution. C'est ici que vous verrez les résultats de vos commandes echo et toute autre sortie de votre script shell.

Examinez attentivement le contenu de la console. Vous devriez y retrouver, ligne par ligne, les messages que vous avez inclus dans votre script. Par exemple, si vous avez utilisé :

echo "Hello Jenkins! Ce message est généré par un script shell."
echo "La date et l'heure actuelles sont : $(date)"

Vous devriez voir ces phrases exactes apparaître, avec la date et l'heure remplacées par les valeurs actuelles. La console affichera également des informations de Jenkins lui-même, comme le début et la fin de l'exécution, et surtout, un message indiquant si le build s'est terminé avec succès ("Finished: SUCCESS") ou en échec ("Finished: FAILURE").

Vérifier le statut du build et interpréter les résultats

Outre la lecture des messages dans la console, l'état global du build est un indicateur clé. Si votre script s'est exécuté sans erreur (c'est-à-dire qu'aucune commande n'a retourné un code d'erreur), Jenkins marquera le build comme un succès. L'icône associée au build dans l'historique (et sur la page du build) sera typiquement bleue ou verte.

Si, au contraire, une commande de votre script a échoué, ou s'il y a eu un problème de configuration, le build sera marqué comme un échec (icône rouge). Dans ce cas, la sortie console est votre meilleure alliée pour diagnostiquer le problème. Les messages d'erreur sont généralement explicites et vous indiqueront quelle commande a posé problème et pourquoi. Les erreurs courantes pour un premier Job peuvent être des fautes de frappe dans les noms de commandes (par exemple, datte au lieu de date) ou des problèmes de permission si le script tente d'accéder à des ressources protégées.

Pour ce projet "Hello Jenkins", si vous avez correctement saisi les commandes echo et que votre environnement Jenkins est fonctionnel, vous devriez obtenir un build réussi. La vérification consiste donc à confirmer :

• Que le build est marqué "SUCCESS".
• Que les messages attendus de votre script sont présents et corrects dans la sortie console.
• Qu'il n'y a pas de messages d'erreur inattendus.

Félicitations ! Si ces conditions sont remplies, vous avez non seulement exécuté votre premier Job Jenkins, mais vous avez aussi appris à vérifier son résultat. Cette compétence de lecture et d'interprétation de la sortie console est absolument fondamentale pour toute utilisation de Jenkins, car elle vous permettra de déboguer et de valider des automatisations bien plus complexes à l'avenir.