Definir 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.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub AE. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório.

Observação: GitHub Actions estava disponível para GitHub Enterprise Server 2.22 como um beta limitado. O beta terminou. GitHub Actions está agora geralmente disponível em GitHub Enterprise Server 3.0 ou posterior. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.


Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.

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 sucesso ou falha.

Status de saídaStatus de verificação de execuçãoDescrição
0successA ação foi concluída com êxito, 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. A execução de verificação e o conjunto de verificações ficam com status failure.

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

Se estiver criando uma ação JavaScript, você poderá usar o pacote @actions/core do conjunto de ferramentas de ações para registrar em log 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, consulte "Criar uma ação JavaScript".

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

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

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

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

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.