A configuração de Deploys define de onde o DevStats obtém os dados de deploy usados nas métricas de Deploy e DORA.
Fontes de Dados
- Provedor Git: Obtenha deploys a partir de merges em uma branch configurada ou de releases publicadas em repositórios compatíveis.
- Enviar pela API: Envie dados de deploy de um pipeline de CI/CD diretamente ao DevStats.
Configurações do Provedor Git
Merge em uma branch
Selecione a branch de deploy, pesquise os repositórios e escolha quais devem receber a configuração. Cada linha exibe sua branch de deploy atual. Clique em Salvar Configurações para aplicar a branch selecionada.
Alterar a branch de deploy recalcula os dados de deploy e pode levar algum tempo, dependendo do tamanho do repositório.
Release
Use esta opção quando publicar uma release representar um deploy no seu fluxo de trabalho.
- Como proprietário ou administrador do workspace, abra Settings → Deploys.
- Selecione Git Provider.
- Em Set Deploy Settings for Repositories, selecione Release.
- Clique em Save Settings.
Release fica disponível quando o workspace tem pelo menos um repositório GitHub ou GitLab. A configuração vale para todo o workspace; não é necessário selecionar uma branch de deploy nem marcar repositórios individualmente. Repositórios de outros provedores não reportam deploys nessa configuração, e a página os lista em um aviso.
O DevStats registra um deploy para uma release publicada usando sua data e hora de publicação. Drafts, prereleases, releases sem data de publicação e releases excluídas não são consideradas. Criar apenas uma tag Git não equivale a publicar uma release. Com Release selecionado, as métricas de deploy usam os deploys originados de releases, sem somá-los aos enviados pela API.
Ao mudar para Release, o DevStats agenda em segundo plano o processamento das releases já sincronizadas dentro da janela histórica de sincronização do workspace. Aguarde esse processamento antes de conferir as métricas de Deploy e DORA. Salvar a configuração Release sem alterá-la não agenda esse processamento novamente.
Para voltar à detecção por branch, selecione Merge to a branch, escolha a branch e os repositórios e salve. As branches de deploy configuradas anteriormente são preservadas enquanto Release está selecionado.
Workspaces com uma configuração existente por tags Git podem mantê-la. Quando há repositórios compatíveis com releases, a página oferece Merge to a branch e Release; selecionar uma delas e salvar substitui a configuração existente por tags.
Configurações da API
Selecione Enviar pela API para enviar deploys a POST /api/v1/deploys. A página oferece gerenciamento do token da API, exemplos para Curl, GitHub Actions e GitLab CI e os campos aceitos no payload. Consulte o guia da API de Deploy para mais detalhes.