Skip to main content

Definindo códigos de saída para ações

Você pode usar códigos de saída para definir o status de uma ação. GitHub exibe os status para indicar a aprovação ou falha das ações.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Sobre os códigos de saída

O GitHub usa o código de saída para definir o status de execução de verificação da ação, que pode ser success ou failure.

Status da saídaStatus de verificação de execuçãoDescrição
0successA ação foi concluída com êxito e outras tarefas que dependem dela podem começar.
Valor diferente de zero (qualquer número inteiro que não seja 0)failureQualquer outro código de saída indica falha na ação. Quando uma ação falha, todas as ações simultâneas são canceladas e as ações futuras são ignoradas. O conjunto de verificação e a execução de verificação obtém um status failure.

Definir um código de saída de falha em uma ação JavaScript

Se você estiver criando uma ação do JavaScript, poderá usar o pacote do kit de ferramentas de ações @actions/core para registrar uma mensagem e definir um código de saída de falha. Por exemplo:

try {
  // something
} catch (error) {
  core.setFailed(error.message);
}

Para obter mais informações, confira "Criando uma ação JavaScript".

Definir um código de saída de falha em uma ação de contêiner do Docker

Se você estiver criando uma ação de contêiner do Docker, poderá definir um código de saída de falha em seu script entrypoint.sh. Por exemplo:

if <condition> ; then
  echo "Game over!"
  exit 1
fi

Para obter mais informações, confira "Como criar uma ação de contêiner do Docker".