Podemos usar a expressão quando Jenkinsfile para especificar as condições sob as quais uma etapa de construção específica ou ação pós-construção deve ser executada. Ele permite que você especifique uma expressão booleana que determina se a etapa de construção ou a ação pós-construção deve ser executada.
Este tutorial abrange o básico de usar a expressão quando se trata de Jenkins Pipelines.
Jenkins quando expressão
A expressão quando deve conter pelo menos uma condição booleana. Você também pode combinar várias condições, mas todas as condições especificadas devem avaliar verdadeiro para o bloco executar.
A seguir, mostra a sintaxe da expressão de quando em Jenkins:
quando
Nesse caso, a expressão booleana que é avaliada antes de executar ou não executar a etapa de construção ou ação pós-construção.
Existem vários tipos de condições que você pode usar na expressão quando, incluindo o seguinte:
Vejamos um exemplo de pipeline de como podemos usar a expressão quando em Jenkins.
Exemplo 1: Exemplo básico
O oleoduto a seguir demonstra um exemplo básico de uso da expressão de quando em Jenkins:
Pipeline
agente qualquer
Parâmetros
booleanparam (nome: 'run_build', defaultValue: false)
estágios
Stage ('Build')
quando
expressão retornar params.Run_build
passos
Echo 'Run Build está definido como True'
No exemplo de exemplo fornecido, o estágio de construção é executado apenas quando o parâmetro run_build é verdadeiro. Por padrão, o valor do parâmetro run_build é falso. Nesse caso, a etapa é ignorada como mostrado na seguinte saída do console:
Se alterarmos o valor do parâmetro run_build para true, a etapa de construção será executada como mostrado no seguinte:
Pipeline
agente qualquer
Parâmetros
booleanparam (nome: 'run_build', defaultValue: true)
estágios
Stage ('Build')
quando
expressão retornar params.Run_build
passos
eco 'corrida de corrida é verdadeira'
A saída do console resultante é a seguinte:
Nesse caso, a mensagem de eco na etapa de construção é executada.
Exemplo 2: Usando não
Também podemos usar a condição não para negar o resultado de uma determinada expressão, conforme demonstrado no seguinte pipeline:
Pipeline
agente qualquer
Parâmetros
booleanparam (nome: 'run_build', defaultValue: false)
estágios
Stage ('Build')
quando
não
expressão retornar params.Run_build
passos
// Etapas de construção vá aqui
Com esta modificação, o estágio de construção é executado apenas se o parâmetro run_build for falso.
Exemplo 3: Usando o alof condicional
Usando a condição de alof, toda a expressão especificada deve ser avaliada para a etapa para executar.
estágio ("Run esta etapa")
quando
tudo de
expressão1
expressão2
Conclusão
A expressão de quando em Jenkins é uma declaração condicional que permite especificar as condições sob as quais uma etapa de construção ou ação pós-construção deve ser executada.
Ele permite que você use as expressões booleanas para controlar a execução do seu pipeline, tornando -o mais flexível e adaptável a diferentes cenários de construção. Você pode usar a expressão quando especificar uma única condição ou combinar várias condições usando operadores lógicos como && (e) e || (ou). Sinta -se à vontade para explorar a documentação para mais.