Conectar o GitLab
O GitLab é um provedor de código completo na plataforma: merge requests, commits, reviews, pipelines e deployments alimentam as mesmas métricas do GitHub (cycle time, DORA, throughput, review).
Como conectar#
- Vá em Integrações e clique em Conectar no card do GitLab.
- Autorize via OAuth: a plataforma pede apenas escopos de leitura.
- Selecione os projetos (repositórios) que quer acompanhar e clique em Ativar.
- A sincronização do histórico começa em segundo plano; as métricas aparecem conforme os dados chegam.
Permissões solicitadas (escopos OAuth)#
| Escopo | Para quê |
|---|---|
read_api | Ler projetos, MRs, commits, pipelines, deployments e issues |
read_user | Identificar o usuário que conecta |
Ambos são escopos somente leitura do GitLab: não há como escrever código ou configuração com eles. O token é criptografado (AES-256) no banco.
Sobre linhas alteradas: para calcular o tamanho de MRs/commits, a plataforma lê o diff em trânsito, conta as linhas e descarta o conteúdo. O código-fonte nunca é armazenado.
O que é sincronizado#
Para cada projeto que você ativar, a plataforma importa:
- Merge requests (tratados como PRs, com os timestamps de ciclo).
- Aprovações e comentários (de linha e gerais).
- Commits e arquivos alterados (só metadados).
- Pipelines (CI): sucesso/falha e duração.
- Deployments/environments (base para o DORA).
- Issues e milestones (alimentam a tela de Projeto).
Webhooks (atualização em tempo real)#
Os webhooks do GitLab são opcionais e opt-in: ao ativar o modo tempo real, a plataforma cria o webhook do projeto para você (é a única escrita que fazemos: uma configuração, nunca código) e o remove ao desconectar. Cada webhook é validado por token secreto. Sem o tempo real, os dados seguem atualizados pela sincronização periódica.