O Que É um Status Check Obrigatório?

Um status check obrigatório é um check de CI que precisa passar antes que um pull request possa fazer merge, transformando um teste automatizado em um gate rígido de merge.

Um status check é um resultado de aprovação ou falha que o CI reporta em um commit ou pull request. Tornar um check obrigatório o eleva de informativo a mandatório: o botão de merge permanece desabilitado até que o check fique verde. É a forma mais simples e mais forte de impor qualidade.

Status checks versus checks obrigatórios

Todo workflow de CI reporta um status, sucesso ou falha, no commit contra o qual rodou. Por padrão, esses são consultivos. Marcar um check específico como obrigatório, em um branch protegido, o torna uma pré-condição para o merge, de modo que um check obrigatório com falha bloqueia o merge por completo.

Como os checks aparecem

Um workflow reporta um check nomeado que aparece no pull request e faz gate do merge.

name: tests
on: [pull_request]
jobs:
  unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

Por que checks obrigatórios importam

Checks obrigatórios removem a tentação de fazer merge de um build vermelho sob pressão. Eles tornam o pipeline verde um gate inegociável, de modo que o branch main permanece pronto para release. Exigir que o branch esteja atualizado também garante que o check rodou contra o código exato que fará merge.

Checks obrigatórios no CI/CD

Status checks obrigatórios são como um pipeline de CI se torna o ponto de imposição da qualidade da entrega. Eles ficam no branch protegido e decidem o que faz merge. Escolher os checks certos para exigir, rápidos e confiáveis, mantém o gate eficaz sem torná-lo um gargalo.

Escolhendo checks obrigatórios

• Exija os checks que realmente fazem gate de qualidade, como testes e lint.
• Mantenha os checks obrigatórios rápidos para que não atrasem os merges.
• Exija um branch atualizado para que os checks rodem no estado de merge.
• Evite checks instáveis como obrigatórios; corrija-os ou coloque-os em quarentena primeiro.

Principais conclusões

• Um status check obrigatório precisa passar antes que um pull request possa fazer merge.
• Ele transforma um resultado de CI consultivo em um gate rígido de merge.
• Checks obrigatórios mantêm o branch main pronto para release e confiável.

Guias relacionados