Sobre o gerenciamento de repositório
Para o GitHub Insights incluir dados de um repositório no GitHub Enterprise, é necessário adicionar a organização proprietária do repositório ao GitHub Insights. Para obter mais informações, consulte "Gerenciar organizações".
Depois de adicionar uma organização ao GitHub Insights, cada repositório pertencente à organização será importado automaticamente se o repositório:
- Tiver pelo menos um commit
- Não for privado
- Não estiver arquivado
- Tiver sido carregado nos últimos 6 meses
Os dados do repositório são atualizados por meio de webhooks e sincronizações periódicas. É possível atualizar manualmente os dados do repositório a qualquer momento ou cancelar a importação de dados em andamento.
Você pode criar um grupo de repositório para ver combinados dados para repositórios relacionados. Você pode filtrar por grupos de repositórios em cada métrica e relatório.
Você pode excluir arquivos específicos do GitHub Insights para um repositório específico ou para todos os repositórios.
Sobre o tempo de importação
O GitHub Insights importa os últimos três anos de dados para cada repositório. Dependendo do tamanho e complexidade dos seus repositórios, a importação inicial pode levar um tempo, durante o qual os dados do GitHub Insights ficarão incompletos. Normalmente, a importação inicial de algumas equipes leva um ou dois dias. As importações iniciais grandes e complexas podem demorar até duas semanas.
| Tamanho do repositório | Tempo da importação inicial |
|---|---|
| < 10.000 commits | < 1 hora |
| 10.000 a 300.000 commits | 1 a 10 dias |
| 300.000 commits ou mais | Mais de 10 dias |
Uma vez concluída a importação inicial, as importações subsequentes de alterações incrementais devem demorar dois minutos ou menos.
Para reduzir os tempos de importação, você pode excluir quaisquer bibliotecas de terceiros em pastas não padrão do GitHub Insights antes da importação. Para obter mais informações, consulte "Gerenciar filtros de exclusão".
Se você tiver muitos repositórios grandes, você poderá melhorar o tempo de importação inicial, fornecendo mais núcleos ao servidor do aplicativo. Servidores do aplicação com mais núcleos podem realizar mais trabalhos de importação paralelos.
| Núcleos do servidor do aplicativo | Trabalhos paralelos de importação inicial |
|---|---|
| 16 núcleos | 1 trabalho |
| 32 núcleos | 4 trabalhos |
A importação de um grande número de pull requests pode acionar a taxa limitadora de GitHub Enterprise. Neste caso, a importação fará uma pausa por uma hora antes de ser restabelecida. Você pode aumentar temporariamente o limite de câmbio de GitHub Enterprise para melhorar o tempo de importação. Para obter mais informações, consulte "Configurar limites de taxa".
Visualizar e gerenciar repositórios
Você pode visualizar os repositórios importados e os repositórios que estão disponíveis para importação. Se uma importação estiver em andamento, você poderá ver o status da importação e uma estimativa de tempo para a conclusão da importação.
- Em GitHub Insights, clique em Settings.
- Em " Settings", clique em Repositories.
- Opcionalmente, para adicionar um repositório que não foi importado, clique em Adicionar à direita do nome do repositório.
- Opcionalmente, para atualizar manualmente os dados do repositório, clique em no ícone de atualização à direita do nome do repositório.
- Opcionalmente, para cancelar a importação em andamento, clique Cancelar à direita do nome do repositório.
- Opcionalmente, para remover um repositório importado, à direita do nome do repositório, clique em Remover.
Gerenciar grupos de repositórios para relatórios
Você pode criar um grupo de repositórios, adicionar ou remover repositórios de um grupo e excluir um grupo de repositórios.
Criar um grupo de repositório
- Em GitHub Insights, clique em Settings.
- Em Settings, clique em Repo groups.
- No canto superior direito da página, clique em Criar grupo.
- Em "Nome do Grupo, digite um nome para o seu grupo.
- Clique em Criar.
Adicionar um repositório a um grupo de repositórios
- Em GitHub Insights, clique em Settings.
- Em Settings, clique em Repo groups.
- À direita do nome do grupo, clique em Edit (Editar).
- Em "Repositórios", use o menu suspenso e selecione um repositório a ser adicionado ao grupo.
- Clique em Cpncluído.
Excluir um grupo de repositórios
- Em GitHub Insights, clique em Settings.
- Em Settings, clique em Repo groups.
- À direita do nome do grupo, clique em Edit (Editar).
- Clique em Excluir Grupo.
- Clique em Confirmar.
Gerenciar filtros de exclusão
Você pode criar uma lista de regras de exclusão de arquivo para omitir arquivos especificados de todos os dados GitHub Insights. As regras de exclusão de arquivos seguem as mesmas regras usadas nos arquivos .gitignore. Para obter mais informações, consulte "gitignore" na documentação do Git.
Adicionar uma regra de exclusão de arquivo para todos os repositórios
Alterações nas exclusões globais de arquivos só se aplicam aos dados recém-importados e não afetarão os dados existentes retroativamente. Para aplicar novas regras de exclusão aos dados existentes, você pode remover e adicionar repositórios novamente ao GitHub Insights.
- Em GitHub Insights, clique em Settings.
- Em Settings, clique em Exclude files.
- Opcionalmente, em "Excluir arquivos", selecione Incluir todos os binários.
- No editor de código, adicione uma nova regra de exclusão à lista.
- Clique em Salvar as alterações.
Adicionar uma regra de exclusão de arquivo para um repositório
- Em GitHub Insights, clique em Settings.
- Em Settings, clique em Exclude files.
- À direita do "Repositórios com filtros de arquivo", clique em Adicionar filtro.
- Use o menu suspenso "Repositório" e selecione um repositório.
- Opcionalmente, para aplicar as regras de exclusão aos dados existentes, selecione Reimportar.
- Opcionalmente, selecione Incluir todos os binários.
- No editor de código, adicione as regras de exclusão que você deseja aplicar ao repositório.
- Clique em Criar Filtro.