Pipeline do GitLab CI travado? Como cancelar jobs presos
Seus pipelines no GitLab estão travados em um loop infinito? Descubra como usar a API REST para limpar jobs presos na fila e restaurar seu fluxo de CI/CD.
Resumo
- Pipelines travados costumam ocorrer por falhas de comunicação entre os Runners e o coordenador do GitLab.
- A interface gráfica nem sempre consegue cancelar jobs que perderam o sinal de execução no sistema.
- O uso da API REST permite intervir diretamente nos estados das instâncias de CI para forçar o término.
- Tokens de acesso pessoal com permissões de API são necessários para autenticar solicitações de limpeza.
- Monitorar o status dos Runners ajuda a prevenir que jobs fiquem orfãos durante picos de carga no CI/CD.
Por que o GitLab CI trava na fila?
Quem trabalha com automação sabe a frustração: você envia um commit e o pipeline fica eternamente em 'pending' ou 'running'. Na prática, isso acontece porque o GitLab Runner, o agente que executa suas tarefas, perdeu a conexão com o servidor ou o job ficou órfão após uma falha catastrófica no container. Assim como ocorre quando temos pods travados no Terminating, o sistema de orquestração nem sempre percebe que a tarefa morreu.
Entendendo o problema dos jobs órfãos
Quando um job trava, ele consome slots de concorrência valiosos. Se o seu limite de execução simultânea é baixo, um ou dois jobs fantasmas podem parar todo o seu fluxo de entrega. Muitas vezes, o erro é uma falha de rede intermitente ou um timeout não tratado pelo agente. Se você já lidou com um container Docker travado, sabe que forçar a parada é a única solução imediata para retomar a operação.
Usando a API REST para limpeza forçada
Para resolver isso sem precisar reiniciar o servidor, usamos a API do GitLab. Primeiro, você precisa de um Personal Access Token com escopo de 'api'. Com ele, podemos listar os jobs presos e cancelar cada um individualmente. O comando abaixo utiliza o cURL para identificar o ID do projeto e o ID do job que precisa ser eliminado.
curl --header "PRIVATE-TOKEN: <seu_token>" "https://gitlab.com/api/v4/projects/<ID_PROJETO>/jobs/<ID_JOB>/cancel" --request POSTAutomatizando a varredura de pendências
Não faz sentido cancelar manualmente se o problema for recorrente. Podemos criar um script simples que filtra jobs no estado 'running' com duração superior a X minutos e solicita o cancelamento via API. Isso evita que você tenha que monitorar o painel constantemente. Assim como fazemos com o NGINX lento, a telemetria proativa economiza horas de suporte técnico.
Conclusão: mantendo o CI/CD saudável
Manter a fila do seu pipeline limpa é vital para uma cultura de deploys rápidos. Quando os jobs estão sempre travando, o problema pode estar no provisionamento dos seus Runners. Considere aumentar os recursos da máquina ou otimizar a comunicação de rede para evitar que as instâncias fiquem isoladas. A gestão manual via API deve ser vista como uma medida de emergência, enquanto a causa raiz deve ser endereçada na infraestrutura.