Execução condicional e dependências de tarefas

Nem toda etapa deve ser executada sempre. Talvez você queira executar uma etapa de implantação apenas no ramo main ou uma etapa de notificação apenas quando algo falhar.

O GitHub Actions permite anexar uma condição if a qualquer etapa ou tarefa para controlar se ela será executada.

Adicione uma chave if: a uma etapa. A etapa só será executada quando a expressão resultar em verdadeiro.

As expressões dentro de if não precisam do invólucro ${{ }}, embora ele seja permitido.

As condições são lidas de objetos de contexto que descrevem a execução:

• github — evento, referência, autor, hash
• env — variáveis de ambiente
• job e steps — status do trabalho anterior
• runner — OS e arquitetura

Por exemplo, github.event_name informa se um envio ou uma solicitação de alteração iniciou a execução.

Por padrão, uma etapa é ignorada se uma etapa anterior falhar. Para substituir esse comportamento, use as funções de status:

• success() — verdadeiro se nenhuma etapa anterior falhou (o padrão)
• failure() — verdadeiro se alguma etapa anterior falhou
• always() — é executada independentemente do que aconteça
• cancelled() — verdadeiro se a execução tiver sido cancelada

Um padrão comum é uma etapa de limpeza que deve ser executada mesmo se etapas anteriores falharem. Use if: always().

Isso garante que recursos temporários, contêineres ou relatórios de testes sejam tratados independentemente do resultado.

A palavra-chave needs faz uma tarefa aguardar outras. Sem ela, as tarefas são executadas em paralelo.

Uma tarefa listada em needs deve ser concluída com êxito antes que a tarefa dependente seja iniciada.

Uma tarefa pode depender de várias outras ao receber uma lista em needs. Ela aguarda todas elas.

É assim que se criam padrões de convergência, nos quais uma tarefa final é executada somente depois que todas as tarefas paralelas são concluídas com êxito.

A chave if também funciona em tarefas, não apenas em etapas. Uma condição no nível da tarefa decide se a tarefa inteira será executada.

Aqui, a tarefa de implantação é executada somente para envios à ramificação main, embora ainda dependa dos testes.

As tarefas podem passar dados para as etapas seguintes por meio de outputs. Uma tarefa dependente lê esses dados através do contexto needs.

Isso permite que uma condição dependa de um valor calculado anteriormente, como a indicação de que uma versão foi alterada.

É possível combinar expressões com && (e), || (ou) e ! (não).

Este exemplo é executado somente para um envio bem-sucedido à ramificação principal que não seja uma bifurcação.

Atenção: uma tarefa com needs é ignorada se uma dependência falhar. Para executar uma tarefa final de geração de relatórios independentemente do resultado, combine needs com if: always().

Dentro dela, você pode inspecionar needs.<job>.result para decidir o que informar.

Teste sua compreensão da execução condicional.

Você aprendeu a controlar o fluxo de trabalho com condições e dependências.

• if controla etapas e tarefas por meio de expressões
• Funções de status como failure() e always() substituem o comportamento de ignorar após uma falha
• needs cria padrões de ordenação e convergência
• As outputs das tarefas fornecem valores para condições posteriores

Esses elementos básicos permitem criar processos precisos e eficientes.