O Que É um Required Status Check no GitHub Actions?

Um required status check é um check de CI que deve passar antes que um pull request possa ser mergeado, imposto por branch protection.

Os workflows reportam um status de aprovado/reprovado a cada commit, mas apenas reportar não bloqueia merges ruins. Os required status checks tornam checks selecionados obrigatórios antes que um pull request possa ser mergeado.

O que é

Um status check, tipicamente o resultado de um job ou workflow, que as regras de branch protection ou rulesets marcam como required. O pull request não pode ser mergeado até que esse check reporte sucesso.

Como funciona

Um job de workflow publica um check com um nome. Nas configurações de branch protection você seleciona esse nome de check como required. O GitHub então bloqueia o merge até que o check passe no commit mais recente.

jobs:
  test:        # this job's name becomes a selectable check
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm test

Modo estrito

Opcionalmente, "require branches to be up to date" força o PR a incluir a base branch mais recente antes do merge, de modo que o check seja executado contra o que realmente vai entrar.

Por que importa

Os required checks são como as equipes impõem quality gates: sem merge sem passar em testes, linting ou scans de segurança. Eles transformam o CI de consultivo em uma barreira rígida.

Conceitos relacionados

Os required checks consomem os statuses produzidos por jobs e runs e complementam as regras de proteção de environment para deploys.

Principais conclusões

• Um required status check deve passar antes do merge.
• Branch protection ou rulesets marcam um check como required.
• Ele transforma o CI em um quality gate imposto.

Guias relacionados