Jenkinsfile quando expressão

Jenkinsfile quando expressão

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:

  1. Filial - Ele especifica um nome de filial ou uma expressão regular que é usada para combinar com a filial atual.
  2. expressão - Ele especifica uma expressão groovy que é avaliada para determinar se a etapa de construção ou ação pós-construção deve ser executada.
  3. não - Nega a condição que se segue.
  4. tudo de - Ele especifica que todas as condições a seguir devem ser verdadeiras para a etapa de construção ou ação pós-construção a ser executada.
  5. qualquer um - Ele especifica que pelo menos uma das condições a seguir deve ser verdadeira para que a etapa de construção ou ação pós-construção seja executada.

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.