O Que É um Status de Pipeline? Lendo Pass, Fail e Pending
Um status de pipeline é o resultado geral de um run, consolidado a partir de seus jobs em estados como success, failure, pending ou cancelled.
Quando você dá uma olhada em um pipeline, o status lhe diz a manchete: ele passou ou falhou, ou ainda está rodando? Esse valor único é calculado a partir dos status de cada job no run. O status é o que os merge gates verificam, o que os dashboards resumem e o que as notificações reportam, então entender como ele é consolidado importa.
Valores de status comuns
- Pending ou queued: aguardando para iniciar.
- Running ou in progress: os jobs estão executando.
- Success ou passed: todos os jobs obrigatórios foram bem-sucedidos.
- Failure ou failed: pelo menos um job obrigatório falhou.
- Cancelled ou skipped: interrompido ou não executado.
Como o status é consolidado
O status do run é derivado de seus jobs. Se todo job obrigatório for bem-sucedido, o run é bem-sucedido. Se algum job obrigatório falhar, o run falha. Jobs marcados como opcionais ou allowed-to-fail geralmente não invertem o status geral.
Status como merge gate
A proteção de branch frequentemente exige um status verde antes que um pull request possa fazer merge. É por isso que um pipeline em falha bloqueia o merge: o status check obrigatório não é satisfeito até que o run passe.
Um exemplo rápido
Em um pull request você vê "All checks have passed" (verde) ou "Some checks were not successful" (vermelho). Clicar mostra qual job falhou, para que você possa ir direto aos logs relevantes.
Status e flakiness
Um status só significa algo se for confiável. Jobs flaky que falham aleatoriamente corroem a confiança no status e levam as pessoas a fazer merge no vermelho ou a re-executar cegamente. Runners estáveis e retries confiáveis mantêm o status significativo; runners gerenciados (Latchkey) reexecutam falhas transitórias de infraestrutura para que um status vermelho reflita mais frequentemente um problema real no código.
Principais conclusões
- O status de pipeline é o resultado do run, consolidado a partir de seus jobs.
- Um job obrigatório que falha faz o run falhar; jobs opcionais geralmente não.
- A proteção de branch usa o status como merge gate, então a flakiness o mina.