这项功能能做什么
连接 Git 平台后选择要分析的仓库。保存连接不会开始首次同步，请从集成卡片手动运行，或在后台任务已启用时等待执行。
适用场景
- 首次导入 Git 数据。
- 检查缺失数据或更新令牌。
开始步骤
- 1使用表单要求的权限：GitHub 为 repo 和 read:user，GitLab 为 read_api 和 read_user。
- 2Bitbucket API 令牌使用 Atlassian 邮箱的 Basic 认证，并需要仓库、PR 和账户读取权限。OAuth 是另一种方式。
- 3自托管实例填写完整 URL，选择仓库后运行同步。
- 4确认完成状态和时间，再打开指标页面。
设置项
| 设置项 | 用途 | 如何使用 | 常见错误 |
|---|---|---|---|
| 令牌和权限 | 提供对 Git 平台仓库的访问。 | 检查权限和有效期。自动化中的实际修改还需要写入权限。 | 认为所有功能都能只用读取权限。 |
| URL 和仓库 | 指定实例及同步数据。 | 确认完整 URL，从团队的仓库开始。 | 包含与本次统计无关的仓库。 |
使用示例
情况: 指标没有显示最近的活动。
- 1检查最近同步并手动运行一次。
- 2失败时查看错误、令牌有效期和仓库权限。
能确认什么: 可以核实问题来自同步还是筛选条件。
常见问题
会读取哪些数据？
提交和 PR 元数据、文件树，以及用于识别技术的部分清单和配置文件。不会克隆完整源代码。令牌使用 AES-256-GCM 加密。
多久同步一次？
后台任务取决于服务器配置，启用时默认约每 30 分钟执行一次，也可手动同步。
删除连接会怎样？
该连接同步的仓库及其提交和 PR 会从 Commitlane 中删除。Git 平台的原始数据不变。若只需更新令牌，请编辑现有连接以保留这些数据。
使用建议
- 增加仓库前，先确认连接状态和已导入数据。