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.

Sobre verificações de status

As verificações de status permitem que você saiba se seus commits atendem às condições definidas para o repositório com o qual está contribuindo.

Neste artigo

As verificações de status se baseiam em processos externos, como compilações de integração contínua, que são executados para cada push que você faz em um repositório. Você pode ver o estado de pendência, aprovação ou falha das verificações de status ao lado de commits individuais em sua pull request.

Lista de commits e status

Qualquer pessoa com permissão de gravação em um repositório pode configurar o estado de qualquer verificação de status no repositório.

É possível ver o estado geral do último commit em um branch na página de branches do seu repositório ou na lista de pull requests do seu repositório.

If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. Para obter mais informações, consulte "Sobre verificações de status obrigatórias".

Tipos de verificação de status no GitHub Enterprise

Há dois tipos de verificação de status no GitHub Enterprise:

  • Verificações
  • Status

Verificações são diferentes de status, pois elas fornecem anotações em linha, mensagens mais detalhadas e estão disponíveis apenas para uso com os aplicativo GitHubs.

Os proprietários da organização e usuários com acesso push a um repositório podem criar verificações e status com a API do GitHub Enterprise. Para obter mais informações, consulte "Verificações" e "Status" na documentação do GitHub Developer.

Verificações

Quando verificações são configuradas em um repositório, as pull requests apresentam uma guia Checks (Verificações), onde é possível exibir o resultado detalhado da compilação de verificações de status e executar novamente as verificações com falha.

Verificações de status em uma pull request

Quando uma linha específica em um commit causar a falha de uma verificação, você verá detalhes sobre a falha, o aviso ou a advertência ao lado do código relevante na guia Files (Arquivos) da pull request.

Detalhes de uma verificação de status

Você pode navegar entre os resumos das verificações de vários commits em uma pull request usando o menu suspenso do commit na guia Conversation (Conversa).

Resumos de verificação para diferentes commits em um menu suspenso

Ignorar e solicitar verificações para commits individuais

Quando um repositório é definido para solicitar verificações por pushes automaticamente, você pode optar por ignorar as verificações para um commit individual do qual fez push. Quando um repositório não é definido para solicitar verificações por pushes automaticamente, você pode solicitar verificações para um commit individual do qual fez push. Para obter mais informações sobre essas configurações, consulte "Conjuntos de verificações" na documentação do GitHub Developer.

Para ignorar ou solicitar verificações para seu commit, adicione uma das seguintes linhas de trailer ao fim da mensagem do commit:

  • Para ignorar verificações para um commit, digite a mensagem do commit e uma descrição breve e significativa das alterações. Após a descrição do commit, em vez de aspas de fechamento, adicione duas linhas vazias seguidas por skip-checks: true:

    $ git commit -m "Update README.
    >
    >
    skip-checks: true
  • Para solicitar verificações para um commit, digite a mensagem do commit e uma descrição breve e significativa das alterações. Após a descrição do commit, em vez de aspas de fechamento, adicione duas linhas vazias seguidas por request-checks: true:

    $ git commit -m "Refactor usability tests.
    >
    >
    request-checks: true

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato