Como usar associações de variáveis em uma tarefa de condição para executar ou parar um pipeline no Automation Pipelines

É 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 Automation Pipelines.

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.

A tarefa de Condição difere em função e comportamento da configuração Na Condição 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
   
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 Automation Pipelines 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 Automation Pipelines.