Skip to main content

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.

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 pendente, aprovado ou com falha das verificações de status ao lado de commits individuais na sua solicitação de pull.

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.

Se as verificações de status forem necessárias para um repositório, as verificações de status necessárias devem passar antes que você possa fazer merge do seu branch no branch protegido. Para obter mais informações, confira "Sobre os branches protegidos".

Tipos de verificação de status no GitHub Enterprise Cloud

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

  • Verificações
  • Status

As verificações são diferentes dos status, pois fornecem anotações de linha, mensagens mais detalhadas e só estão disponíveis para uso nos GitHub Apps.

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 Cloud. Para obter mais informações, confira "Verificações" e "Status".

Verificações

Quando as verificações são configuradas em um repositório, as solicitações de pull têm uma guia Verificações em que você pode ver a saída de build detalhada das verificações de status e executar novamente as verificações com falha.

Verificações de status em uma pull request

Observação: a guia Verificações só será preenchida para solicitações de pull se você configurar verificações, não status, para o repositório.

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

Detalhes de uma verificação de status

Navegue entre os resumos das verificações de vários commits em uma solicitação de pull usando o menu suspenso do commit na guia 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 para pushes automaticamente, você pode solicitar verificações para um commit individual enviado por push. Para obter mais informações sobre essas configurações, confira "Pacotes de verificação".

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

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

Retenção de verificações de status

Verifica se os dados com mais de 400 dias estão arquivados. Como parte do processo de arquivamento, o GitHub cria um status de confirmação de rollup que representa o estado de todas as verificações para essa confirmação. Como consequência, a caixa de mesclagem em qualquer solicitação pull com verificações arquivadas necessárias estará em um estado bloqueado e você precisará executar novamente as verificações antes de poder mesclar a solicitação pull.