GitHub/GitLab

通过代码关联集成 GitHub/GitLab，将代码提交和 Project 模块结合使用。‌

1 配置代码关联集成

1.1 新建关联代码仓

如果你使用的是 ONES 私有部署版，请联系客服。ONES 的技术人员将为你准备基础配置，以便于能正常关联 GitHub/GitLab 代码仓。

前往 Pipeline 配置中心的代码仓管理页面，点击「新建关联代码仓」以关联当前团队所需 GitHub/GitLab 代码仓。

通过 OAuth 的方式认证 GitHub/GitLab，以便系统能获取自动配置代码仓 Webhook 的权限。

• 如果未认证过 GitHub/GitLab，请点击「新建认证」按钮；在打开的 GitHub/GitLab 平台的界面中确认授权认证 ONES；授权认证 ONES 成功后，系统会引导你回到 ONES 系统。

• 如果你已认证过 GitHub/GitLab，但想修改认证帐号，请在浏览器的无痕模式下点击弹窗中的「重新认证」，登录新帐号并重新认证后，系统会引导你回到 ONES 系统。

OAuth 认证成功后，你需要选择代码仓并完成新建关联代码仓。

1. 目前系统最多能获取到 GitHub/GitLab 的 100 个代码仓。如果希望关联 100 以上个代码仓，你需要将代码仓划分到不同的 GitHub/GitLab 帐号中进行关联。

2. 操作关联的用户在 GitHub 中至少具有「Owner」权限、在 GitLab 中至少具有「Maintainor」权限，否则系统无权限自动配置代码仓的 Webhook，你需要手工配置。

新建关联代码仓后，系统会自动在代码仓中配置 Webhook。你可以在代码仓详情中检查 Webhook 的配置状态。

1.2 重置 Webhook

Webhook 用于允许 ONES 监听代码平台上的特定提交事件。新建关联代码仓后，你可以通过以下方式重新配置 Webhook。

• 系统自动重置 Webhook 如果 Webhook 失效或被人为删除，你可以点击「重置 Webhook」按钮，系统会自动重置代码仓中的 Webhook。

• 手工配置 Webhook 点击「手工配置 Webhook」按钮，你可以查看当前代码仓的 Webhook 的配置信息，再进入 Git 平台中手工添加 Webhook。

1.3 移除关联代码仓

如果不需要再获取某代码仓的代码提交数据，你可以移除关联此代码仓。 移除关联代码仓不影响历史已获取的代码提交数据。

2 代码提交关联工作项

团队成员可以在代码提交 (commit message) 的时候通过输入包含工作项 ID 的方式和工作项进行关联。 目前一次代码提交支持与多个工作项同时进行绑定，请在多个工作项 ID 之间添加空格作为分隔，例如“#1 工作项一 #2 工作项二”。

3 查看代码关联结果

需求自动关联代码提交及其触发的持续集成数据，以便代码提交数据与项目管理结合。你可以在工作项详情的“代码关联”栏位查看代码关联结果。

迭代支持汇总需求已关联的代码提交数据，迭代负责人可以据此跟进开发进展。

迭代概览下将汇总统计当前迭代的代码提交情况，帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。