Primeiros Passos
Pré-requisitos
- Docker instalado
- Uma conta no NVIDIA NIM com API key
- Um projeto GitLab com acesso à API
1. Build da imagem
git clone https://git.rarolabs.com.br/devops/raro-reviewer.git
cd raro-reviewer
docker build -t raro-reviewer .
2. Configurar variáveis de ambiente
Crie um arquivo .env na raiz do projeto:
# .env
GITLAB_URL=https://gitlab.com/api/v4
GITLAB_TOKEN=glpat-seu-token-aqui
GITLAB_WEBHOOK_SECRET=um-segredo-forte-e-longo
NVIDIA_API_KEY=nvapi-sua-chave-aqui
:::warning Segurança
Nunca commite o arquivo .env no repositório. Adicione-o ao .gitignore.
:::
3. Iniciar o container
docker run --rm -p 8000:8000 \
--env-file .env \
raro-reviewer
4. Verificar saúde
curl http://localhost:8000/healthz
Resposta esperada:
{"status": "ok"}
5. Configurar o webhook no GitLab
- Acesse seu projeto no GitLab
- Vá em Settings → Webhooks
- Preencha:
- URL:
http://seu-ip:8000/webhook - Secret Token: o mesmo valor de
GITLAB_WEBHOOK_SECRET - Trigger: marque Merge request events
- URL:
- Clique em Add webhook
6. Testar
Abra um novo Merge Request no GitLab. O raro-reviewer receberá o webhook, analisará o diff e postará comentários inline no MR.