Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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 One. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. Para obter mais informações, consulte "produtos de GitHub

Neste artigo

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 zerofailureQualquer 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ê?

Privacy policy

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.