O Que É um Status Check?
Um status check é um resultado de aprovado ou reprovado que um sistema automatizado reporta em relação a um commit ou pull request, como "tests passed."
Aquelas marcas de confirmação verdes e Xs vermelhos em um pull request são status checks. Cada um é um veredicto de um processo automatizado, build, tests, linting, security scan, dizendo a você e à plataforma se aquele aspecto da mudança está saudável.
O que é
Um status check é um resultado nomeado, sucesso, falha ou pendente, anexado a um commit específico por um sistema de CI ou outra ferramenta. Um único pull request geralmente carrega vários: um para o build, um para os tests, um para o linting, e assim por diante. Juntos eles dão uma visão rápida da saúde da mudança.
Como checks obrigatórios controlam merges
Quando um status check é marcado como obrigatório pela branch protection, a plataforma não permitirá que a mudança faça merge até que aquele check reporte sucesso. Um check obrigatório reprovado ou pendente desabilita o botão de merge. Isso transforma os resultados de CI de informação consultiva em um gate aplicado.
Um exemplo
Um pull request mostra três checks: build passed, tests passed, lint failed. Como o check de lint é obrigatório, o botão de merge fica desabilitado. O autor corrige a formatação, faz push, os checks rodam novamente, os três ficam verdes, e agora a mudança pode fazer merge.
Por que importam
Status checks tornam o resultado da verificação automatizada visível e acionável bem onde as decisões são tomadas, no pull request. Eles permitem que os revisores confiem que a mecânica está sólida e foquem no design. Como checks obrigatórios, eles aplicam qualidade automaticamente, sem que ninguém precise policiar manualmente.
Mantendo os checks significativos
- Deixe os checks rápidos para que não criem gargalo no merge.
- Mantenha-os confiáveis; checks instáveis corroem a confiança.
- Marque como obrigatórios apenas os que realmente importam.
- Garanta que um check verde signifique genuinamente que a mudança é segura.
Principais conclusões
- Um status check é um veredicto de aprovado/reprovado em um commit ou PR.
- Checks obrigatórios bloqueiam o merge até que tenham sucesso.
- Eles tornam os resultados de CI visíveis e os transformam em gates aplicados.