文章版本: Enterprise Server 2.17
管理仓库
您可以管理连接到 GitHub Insights 的仓库以及每个仓库的指标中包含的数据。
GitHub Insights 可用于 GitHub One。 更多信息请参阅“GitHub 的产品”。
关于仓库管理
要让 GitHub Insights 包含来自 GitHub Enterprise 中的仓库的数据,您必须将拥有该仓库的组织添加到 GitHub Insights。 更多信息请参阅“管理组织”。
将组织添加到 GitHub Insights 后,该组织拥有的每个仓库在满足以下要求时将自动导入:
- 至少有一个提交
- 不是私有仓库
- 未存档
- 在最近 6 个月内有推送
仓库数据通过 web 挂钩定期同步更新。 您可以随时手动刷新仓库数据或取消正在进行的数据导入。
您可以创建仓库组来查看相关仓库的合并数据。 您可以在每个指标和报告中按仓库组筛选。
您可以从 GitHub Insights 中排除特定仓库或所有仓库的特定文件。
关于导入时间
GitHub Insights 可导入每个仓库最近三年的数据。 根据仓库的大小和复杂性,初始导入可能需要一段时间,在此期间 GitHub Insights 数据不完整。 通常,初始导入需要一到两天。 大型而复杂的初始导入可能需要长达一周的时间。
仓库大小 | 初始导入时间 |
---|---|
< 10,000 个提交 | < 1 小时 |
10,000 至 40,000 个提交 | < 1 天 |
> 40,000 个提交 | < 5 天 |
完成初始导入后,因增量变化而进行的后续导入将需要两分钟或更短时间。
要减少导入时间,您可以在导入之前从 GitHub Insights 中排除非标准文件夹中的任何第三方库。 更多信息请参阅“管理排除过滤器”。
如果您有许多大型仓库,可通过提供具有更多内核的应用程序服务器来缩短初始导入时间。 具有更多内核的应用程序服务器可执行更多并发导入作业。
应用程序服务器内核 | 并发初始导入作业 |
---|---|
16 个内核 | 6 个作业 |
32 个内核 | 14 个作业 |
导入大量的拉取请求可能会触发 GitHub Enterprise 的速率限制。 在这种情况下,导入将暂停一小时后再恢复。 为缩短导入时间,您可以暂时增加 GitHub Enterprise 的速率上限。 更多信息请参阅“配置速率限制”。
查看和管理仓库
您可以查看已导入仓库和可导入的仓库。 如果导入正在进行,您可以查看导入状态和预计的导入完成时间。
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在“ Settings(设置)”下,单击 Repositories(仓库)。
- (可选)要添加尚未导入的仓库,请在该仓库名称的右侧,单击 Add(添加)。
- (可选)要手动刷新仓库数据,请在该仓库名称的右侧,单击 刷新按钮。
- (可选)要取消正在进行的导入,请在该仓库名称的右侧,单击 Cancel(取消)。
- (可选)要删除已导入仓库,请在该仓库名称的右侧,单击 Remove(删除)。
管理报告的仓库组
您可以创建仓库组、在组中添加或删除仓库以及删除仓库组。
创建仓库组
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在 Settings(设置)下,单击 Repo groups(仓库组)。
- 在右上角,单击 Create Group(创建组)。
- 在“Group Name(组名称)”下,输入组的名称。
- 单击 Create(创建)。
将仓库添加到仓库组
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在 Settings(设置)下,单击 Repo groups(仓库组)。
- 在组名称右侧,单击 Edit(编辑)。
- 在“Repositories(仓库)”下,使用下拉菜单选择要添加到组的仓库。
- 单击 Done(完成)。
删除仓库组
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在 Settings(设置)下,单击 Repo groups(仓库组)。
- 在组名称右侧,单击 Edit(编辑)。
- 单击 Delete Group(删除组)。
- 单击 Confirm(确认)。
管理排除过滤器
您可以创建文件排除规则列表,以从所有 GitHub Insights 数据中忽略指定文件。 文件排除规则遵循在 .gitignore 文件中使用的相同规则。 更多信息请参阅 Git 文档中的“gitignore”。
为所有仓库添加文件排除规则
全局文件排除项的更改仅适用于新导入的数据,不会追溯影响现有数据。 要将新的排除规则应用于现有数据,您可以删除仓库,然后将其重新添加到 GitHub Insights。
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在 Settings(设置)下,单击 Exclude files(排除文件)。
- (可选)在“Exclude files(排除文件)”下,选择 Include all binaries(包括所有二进制文件)。
- 在代码编辑器中,将新的排除规则添加到列表。
- 单击 Save Changes(保存更改)。
为一个仓库添加文件排除规则
- 在 GitHub Insights 中,单击 Settings(设置)。
- 在 Settings(设置)下,单击 Exclude files(排除文件)。
- 在“Repositories with File Filters(带有文件过滤器的仓库)”的右侧,单击 Add Filter(添加过滤器)。
- 使用“Repository(仓库)”下拉菜单选择一个仓库。
- (可选)要对现有数据应用排除规则,请选择 Re-import(重新导入)。
- (可选)选择 Include all binaries(包括所有二进制文件)。
- 在代码编辑器中,添加要应用到仓库的排除规则。
- 单击 Create Filter(创建过滤器)。