Analyse des étapes et des logs via l'interface Blue Ocean (si activée)

Introduction à Blue Ocean : une expérience utilisateur moderne pour Jenkins

Si votre instance Jenkins dispose du plugin Blue Ocean et qu'il est activé, vous avez accès à une interface utilisateur alternative et moderne, spécifiquement conçue pour améliorer la visualisation et l'interaction avec les Pipelines Jenkins. Blue Ocean offre une expérience plus graphique et intuitive que l'interface Jenkins classique, en particulier pour le suivi des exécutions de pipelines complexes, le diagnostic des problèmes et la lecture des logs.

L'objectif de cette section est de vous montrer comment utiliser Blue Ocean pour analyser les étapes et les logs de votre pipeline CI que vous venez de créer. Si Blue Ocean n'est pas installé sur votre Jenkins, cette section vous donnera un aperçu de ses avantages, et vous pourrez toujours analyser les logs via l'interface classique comme décrit précédemment. Blue Ocean est particulièrement apprécié pour sa clarté dans la représentation des flux d'exécution parallèles et des étapes conditionnelles, bien que notre pipeline actuel soit séquentiel et simple.

Accéder à Blue Ocean se fait généralement via une icône dédiée (souvent un cercle bleu ou un lien "Open Blue Ocean") dans l'en-tête ou le menu latéral de l'interface Jenkins classique. Une fois dans Blue Ocean, vous retrouverez vos pipelines listés d'une manière plus visuelle.

Naviguer vers votre pipeline et visualiser son exécution dans Blue Ocean

Une fois dans l'interface Blue Ocean, vous verrez une liste de vos pipelines. Localisez celui que vous avez créé pour le projet de la page web statique (par exemple, MonPremierPipelineCI) et cliquez dessus. Cela vous mènera à une page dédiée à ce pipeline, affichant l'historique de ses exécutions d'une manière chronologique et graphique.

Cliquez sur la dernière exécution (ou celle que vous souhaitez analyser). Blue Ocean présentera alors une vue détaillée de cette exécution spécifique. La caractéristique la plus frappante est la représentation visuelle du pipeline sous forme de colonnes ou de blocs représentant chaque stage défini dans votre Jenkinsfile (par exemple, "Checkout SCM", "Simulate Build", "Simulate Test").

L'état de chaque stage (succès, échec, en cours) est clairement indiqué par des codes couleurs (vert pour succès, rouge pour échec, bleu ou jaune pour en cours/instable) et des icônes. Cette vue d'ensemble permet d'identifier immédiatement quelle étape a potentiellement causé un problème ou où le pipeline s'est arrêté. Pour notre pipeline simple, vous devriez voir toutes les étapes en vert si l'exécution a réussi.

Analyser les logs d'une étape spécifique avec Blue Ocean

L'un des points forts de Blue Ocean est la facilité avec laquelle on peut accéder aux logs d'une étape (step) spécifique à l'intérieur d'un stage. Dans la vue de l'exécution du pipeline, cliquez sur le stage qui vous intéresse (par exemple, "Simulate Build"). La vue pourrait alors se concentrer sur ce stage, ou une section de logs pourrait apparaître.

Blue Ocean affiche souvent les étapes (steps) individuelles au sein d'un stage. Si vous avez plusieurs commandes sh ou echo dans un même stage, Blue Ocean peut les présenter comme des sous-étapes cliquables. En cliquant sur une de ces étapes (ou sur le stage lui-même si les logs sont regroupés), la sortie console correspondante s'affiche de manière claire et souvent avec une coloration syntaxique pour les commandes.

Par exemple, si vous cliquez sur l'étape "Simulate Build", vous devriez voir les logs correspondants, incluant vos messages echo 'Début de la simulation de construction...', la sortie de la commande sh 'ls -la', et echo 'Simulation de construction terminée.'. Les logs sont généralement présentés de manière séquentielle et horodatée. Blue Ocean permet aussi de filtrer les logs ou de rechercher des termes spécifiques, ce qui est très utile pour les pipelines générant beaucoup de sorties.

Comparez cette expérience avec la consultation des logs dans l'interface classique. Beaucoup trouvent Blue Ocean plus direct pour naviguer entre les logs de différentes étapes sans avoir à faire défiler une longue sortie console unique. Il est également possible de voir les artefacts produits par le build ou les tests si votre pipeline est configuré pour en générer et les archiver.

Avantages de Blue Ocean pour le diagnostic et le suivi

L'utilisation de Blue Ocean pour l'analyse des pipelines offre plusieurs avantages, surtout à mesure que vos pipelines deviennent plus complexes. La visualisation graphique des stages permet une compréhension rapide du flux d'exécution et des dépendances. En cas d'échec, l'étape problématique est immédiatement mise en évidence, vous faisant gagner du temps dans le diagnostic.

La navigation dans les logs est également améliorée. Plutôt que de parcourir un fichier de log monolithique, Blue Ocean vous permet de cibler les logs d'une étape précise, rendant l'analyse plus focalisée. Pour les pipelines avec des branches parallèles (par exemple, exécuter des tests sur différents environnements en même temps), Blue Ocean excelle à montrer ces exécutions parallèles et leur état respectif.

Bien que notre pipeline actuel soit simple, prendre l'habitude d'utiliser Blue Ocean (s'il est disponible) peut grandement améliorer votre productivité avec Jenkins. Il ne remplace pas la nécessité de comprendre le fonctionnement de Jenkins et la structure des Jenkinsfiles, mais il offre une surcouche ergonomique qui facilite grandement le quotidien des développeurs et des équipes DevOps. Si vous avez l'occasion, explorez les différentes vues et options que Blue Ocean propose pour une exécution donnée ; vous pourriez découvrir des fonctionnalités qui vous seront très utiles pour vos futurs projets.