Jenkinsfile lorsque l'expression

Nous pouvons utiliser l'expression quand dans un JenkinsFile pour spécifier les conditions dans lesquelles une étape de construction particulière ou une action post-construction doit être exécutée. Il vous permet de spécifier une expression booléenne qui détermine si l'étape de construction ou l'action post-construction doit être exécutée.

Ce tutoriel couvre les bases de l'utilisation de l'expression quand en ce qui concerne les pipelines Jenkins.

Jenkins lorsque l'expression

L'expression quand doit contenir au moins une condition booléenne. Vous pouvez également combiner plusieurs conditions, mais toutes les conditions spécifiées doivent évaluer vrai pour que le bloc fonctionne.

Ce qui suit montre la syntaxe de l'expression quand dans les Jenkins:

quand

Dans ce cas, le spécifie l'expression booléenne qui est évaluée avant d'exécuter ou de ne pas exécuter l'étape de construction ou l'action post-construction.

Il existe plusieurs types de conditions que vous pouvez utiliser dans l'expression du moment, y compris ce qui suit:

1. Bifurquer - Il spécifie un nom de branche ou une expression régulière qui est utilisée pour correspondre à la branche actuelle.
2. expression - Il spécifie une expression groovy qui est évaluée pour déterminer si l'étape de construction ou l'action post-construction doit être exécutée.
3. pas - Il annule la condition qui le suit.
4. tous - Il spécifie que toutes les conditions qui le suivent doivent être vraies pour l'exécution de l'étape de construction ou après la construction.
5. n'importe quel - Il spécifie qu'au moins l'une des conditions qui le suivent doit être vraie pour l'étape de construction ou l'action post-construction à exécuter.

Voyons un exemple de pipeline sur la façon dont nous pouvons utiliser l'expression quand dans Jenkins.

Exemple 1: Exemple de base

Le pipeline suivant montre un exemple de base utilisation de l'expression quand dans les Jenkins:

pipeline
agent
paramètres
booleanparam (nom: 'run_build', defaultValue: false)

étapes
étape ('build')
quand
expression return params.Run_build

pas
Echo 'Run build est défini sur true'

Dans l'exemple fourni, l'étape de construction n'est exécutée que lorsque le paramètre run_build est vrai. Par défaut, la valeur du paramètre run_build est fausse. Dans ce cas, l'étape est ignorée comme indiqué dans la sortie de la console suivante:

Si nous modifions la valeur du paramètre run_build en true, l'étape de construction est exécutée comme indiqué dans les éléments suivants:

pipeline
agent
paramètres
booleanparam (nom: 'run_build', defaultValue: true)

étapes
étape ('build')
quand
expression return params.Run_build

pas
Echo 'Run build est vrai'

La sortie de la console résultante est la suivante:

Dans ce cas, le message d'écho dans l'étape de construction est exécuté.

Exemple 2: Utiliser Not

Nous pouvons également utiliser la condition NOT pour nier le résultat d'une expression donnée comme démontré dans le pipeline suivant:

pipeline
agent
paramètres
booleanparam (nom: 'run_build', defaultValue: false)

étapes
étape ('build')
quand
pas
expression return params.Run_build


pas
// Créer des étapes allez ici

Avec cette modification, l'étape de construction n'est exécutée que si le paramètre run_build est faux.

Exemple 3: Utilisation de l'allof conditionnel

En utilisant la condition allof, toute l'expression spécifiée doit évaluer à TRUE pour que l'étape s'exécute.

étape ("exécuter cette étape")
quand
tous
expression1
expression2

Conclusion

L'expression quand dans Jenkins est une déclaration conditionnelle qui vous permet de spécifier les conditions dans lesquelles une étape de construction ou une action post-construction doit être exécutée.

Il vous permet d'utiliser les expressions booléennes pour contrôler l'exécution de votre pipeline, ce qui le rend plus flexible et adaptable à différents scénarios de construction. Vous pouvez utiliser l'expression quand spécifier une condition unique ou pour combiner plusieurs conditions à l'aide d'opérateurs logiques tels que && (et) et || (ou). N'hésitez pas à explorer la documentation pour en savoir plus.