Jenkins - 2.5 Ajouter de la logique avec un paramètre booléen
Un script Jenkins peut réagir à un choix de l'utilisateur. Cette leçon ajoute un troisième paramètre de type booléen, c'est-à-dire vrai ou faux. Selon sa valeur, le script affiche un message ou un autre. Vous verrez ensuite comment tester ce comportement directement dans Jenkins.
Ajouter le paramètre booléen
Un paramètre booléen ne peut valoir que vrai ou faux. Il est ajouté au script comme troisième paramètre, avec un nom explicite.
Par défaut, la case est cochée, donc la valeur est vraie. Si l'on décoche la case, la valeur devient fausse.
- Ajouter le troisième paramètre au script.
- Laisser la case cochée pour avoir la valeur vraie par défaut.
- Sauvegarder le script.
Afficher un message selon la valeur
Une condition if vérifie la valeur du paramètre. Si elle est vraie, le script affiche un premier message. Sinon, il affiche un autre message d'erreur.
Exécuté hors de Jenkins, le script produit une erreur, car l'option n'existe pas encore. Il faut le lancer dans Jenkins, où le paramètre est défini.
Tester dans Jenkins
Le script est copié dans le conteneur Docker, puis la page est rafraîchie. Dans le build, la sortie de la console montre le résultat de l'exécution.
Pour tester, on saisit un nom et un prénom, puis on lance le job avec la case cochée, puis décochée. Le message affiché change selon la valeur choisie.
En résumé
Un paramètre booléen permet au script de choisir entre deux comportements. La condition if affiche un message selon que la valeur est vraie ou fausse. Les tests se font dans Jenkins, où la sortie de la console confirme le résultat. Cette méthode fonctionne aussi avec d'autres types de paramètres, comme les listes.
Points clés
- Un booléen ne peut valoir que vrai ou faux.
- La valeur par défaut d'une case cochée est vraie.
- Une condition if choisit le message à afficher.
- Le test se fait dans Jenkins, et non hors du conteneur.
- La sortie de la console permet de vérifier l'exécution.
Questions fréquentes
Que se passe-t-il si je décoche la case ?
La valeur du paramètre devient fausse, et le script affiche le message prévu pour ce cas.
Pourquoi une erreur apparaît-elle en dehors de Jenkins ?
Le paramètre n'existe que dans le job Jenkins. Hors de Jenkins, le script ne le trouve pas.
Où voir le résultat de l'exécution ?
Dans le build, à la rubrique de la sortie de la console, après avoir rafraîchi la page.