É possível fazer com que a saída de uma tarefa no pipeline determine se o pipeline é executado ou interrompido com base em uma condição fornecida. Para aprovar ou reprovar o pipeline com base na saída da tarefa, use a tarefa de Condição.

A tarefa de Condição pode ser usada como um ponto de decisão no pipeline. Usando a tarefa Condição com uma expressão de condição fornecida, é possível avaliar quaisquer propriedades em seu pipeline, estágios e tarefas.

O resultado da tarefa Condição determina se a próxima tarefa no pipeline será executada.

  • Uma condição verdadeira permite que a execução do pipeline continue.
  • Uma condição falsa interrompe o pipeline.

Para obter exemplos de como usar o valor de saída de uma tarefa como a entrada para a próxima tarefa vinculando as tarefas a uma tarefa Condição, consulte Como usar associações de variáveis em pipelines do Code Stream.

Tabela 1. Como a tarefa de Condição e sua expressão de condição se relacionam com o pipeline
Tarefa de Condição O que isso afeta O que ele faz

Tarefa de Condição

Pipeline

A tarefa de Condição determina se o pipeline é executado ou interrompido nesse ponto, dependendo de a saída da tarefa ser verdadeira ou falsa.

Expressão de Condição

Saída da tarefa de Condição

Quando o pipeline é executado, a expressão de condição incluída na tarefa de Condição produz um status de saída verdadeiro ou falso. Por exemplo, uma expressão de condição pode exigir que o status de saída da tarefa de Condição seja Concluído ou pode usar um número de compilação de 74.

A expressão de condição aparece na guia Tarefa na tarefa de Condição.

As construções com suporte para a expressão condicional aparecem e fornecem exemplos para variáveis de pipeline, variáveis de saída de tarefa, valores e operadores.

A tarefa de Condição difere em função e comportamento da configuração Na Condição em outros tipos de tarefas.

A configuração Na Condição está disponível em outros tipos de tarefas.

Em outros tipos de tarefas, Na Condição determina se a tarefa atual é executada, em vez de tarefas sucessivas, com base na avaliação de sua expressão de condição prévia de verdadeiro ou falso. A expressão de condição da configuração Na Condição produz um status de saída verdadeiro ou falso para a tarefa atual quando o pipeline é executado. A configuração Na Condição aparece na guia Tarefa com sua própria expressão de condição.

Este exemplo usa a tarefa de Condição.

Pré-requisitos

  • Verifique a existência de um pipeline e se ele inclui estágios e tarefas.

Procedimento

  1. No pipeline, determine o ponto de decisão no qual a tarefa de Condição deve aparecer.
  2. Adicione a tarefa de Condição antes da tarefa que depende do seu status de aprovada ou reprovada.
  3. Adicione uma expressão de condição à tarefa de Condição.
    Por exemplo: "${Stage1.task1.output.status}" == "COMPLETED" || ${input.buildNumber} == 74
    Adicione uma tarefa de Condição com uma expressão de condição que é avaliada como verdadeira ou falsa quando o pipeline é executado.
  4. Valide a tarefa.
  5. Salve o pipeline, em seguida, ative e execute-o.

Resultados

Observe as execuções do pipeline e observe se o pipeline continua em execução ou para na tarefa de Condição.

O que Fazer Depois

Se você reverter uma implantação de pipeline, também poderá usar a tarefa de Condição. Por exemplo, em um pipeline de reversão, a tarefa de Condição ajuda o Code Stream a marcar uma falha de pipeline com base na expressão de condição e pode disparar um único fluxo de reversão para vários tipos de falha.

Para reverter uma implantação, consulte Como faço para reverter minha implantação no Code Stream.