Logo

Conectar o Jenkins

O Jenkins traz a camada de CI/CD para quem constrói e faz deploy fora do provedor de código: seu código pode estar no GitHub/GitLab/Azure e o pipeline rodar no Jenkins. Conectado, ele alimenta a aba CI (saúde de build) e o DORA (frequência de deploy, lead time, change failure rate, MTTR), além do value stream ticket → produção.

O Jenkins não adiciona repositórios: ele enriquece os repositórios que você já conectou de um SCM. Cada build é casado a um repositório pela URL git que o build reporta.

Como funciona (em uma frase)#

O Jenkins envia cada build para uma URL secreta da plataforma (webhook). Não precisamos de credenciais nem de alcançar o seu Jenkins. Funciona mesmo com Jenkins atrás de firewall/VPN (o tráfego sai do Jenkins).

Pré-requisitos#

  • Ser Owner ou Admin da organização na plataforma.
  • Ter pelo menos um repositório conectado (GitHub/GitLab/Azure). O Jenkins aumenta esses repos.
  • O seu Jenkins precisa conseguir alcançar a URL do webhook da plataforma.

Passo a passo#

  1. Integrações → Jenkins → Conectar e informe a URL do seu Jenkins.
  2. Copie a URL secreta do webhook que aparece em Gerenciar Jenkins.
  3. Configure o Jenkins para enviar os builds para essa URL, de duas formas (qualquer uma):
    • Notification Plugin: adicione um endpoint Format: JSON, Protocol: HTTP, Event: All com a URL.
    • curl no Jenkinsfile (bloco post): um POST com o JSON do build.
  4. Marque os jobs de deploy: em Gerenciar Jenkins, preencha o ambiente (ex.: production) dos jobs que fazem deploy. Jobs sem ambiente entram como builds de CI.

O payload precisa conter o SCM do build (url, branch, commit). É o que casa o build com um repositório conectado e liga o deploy ao PR/ticket pelo commit (SHA).

O que aparece#

  • Deploys → aba CI: taxa de sucesso, duração, runs por dia e quebra por job (pipeline) do Jenkins.
  • Deploys → DORA: os jobs marcados como deploy viram a frequência de deploy, lead time, CFR e MTTR.
  • Projeto → Fluxo de valor: o deploy do Jenkins fecha o ciclo ticket → produção.

Perguntas frequentes#

Preciso abrir meu Jenkins para a internet? Não. É o Jenkins que envia para a nossa URL. Só ele precisa alcançar a plataforma; nós nunca acessamos o seu Jenkins.

Meus builds não aparecem. Confirme que o payload inclui scm.url/branch/commit e que o repositório correspondente está conectado e ativo num SCM. Builds de repositórios não conectados são ignorados.

Como um build vira "deploy"? Em Gerenciar Jenkins, preencha o ambiente do job (ex.: production). Sem ambiente, o job é tratado como build de CI. Veja também Projetos e múltiplos trackers e Dashboards e telas (seção Deploys).

A URL do webhook vazou. Em Gerenciar Jenkins, clique em Rotacionar e atualize a URL na configuração do Jenkins. O token antigo deixa de ser aceito na hora.

Próximos passos#

AnteriorAzure DevOpsPróximoPagerDuty