通过代码关联集成 私有 Bitbucket，将代码提交和 Project 模块结合使用。

使用流程

新建关联私有部署 Bitbucket 类型代码仓

1.在「Pipeline 配置中心」-> 「代码仓管理」中，点击「新建关联代码仓」。

2. 在「新建关联代码仓」弹窗中，选择「私有 Bitbucket」代码仓类型，点击「新建认证」按钮新建私有 Bitbucket 认证。

3. 在「认证私有 Bitbucket」弹窗中，填写私有 Bitbucket URL，请根据你的 Bitbucket 服务地址填写。

注意：推荐使用 Bitbucket 6.0或以上版本，低于6.0版本无法保证完全支持。

4. 选择认证方式。你可以选择「用户名+密码」或者「Token」两种方式进行认证。请确保你填写的用户名或 Token 在Bitbucket 服务中至少具有以下权限：Project 下 Read 权限，Repository 下 Admin 权限。

5. 填写完信息后即可提交认证，系统将检查认证是否有效，若有效即认证添加成功。回到「新建关联代码仓」弹窗，可以选择需要添加关联的代码仓。（可选代码仓取决于认证用户可见代码仓）。点击确定后即完成代码仓关联。

6. 可对已经关联代码仓进行「移除」、「重置 Webhook」或「手工配置 Webhook」等操作。

7. 在关联的 Bitbucket 代码仓中提交代码，并在 Commit message 中输入包含工作项 ID 的内容，即可将代码提交与 ONES 中的工作项、迭代进行关联。

什么是代码关联集成？

代码仓集成是将代码仓的代码提交情况与 ONES Project 的任务相关联，例如，团队成员完成编码后，提交时在（Commit message） 输入包含本段代码涉及的研发任务的 ID，通过“空格”隔开，提交后可以在 ONES 实时查看代码提交情况。

目前 ONES 支持集成 GitHub、GitLab、私有 GitLab、SVN、私有 Bitbucket 等类型的代码仓。以下内容是各类代码仓的详细集成配置和使用说明。

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

1 配置代码关联集成

1.1 新建关联代码仓

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

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

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

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

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

新建关联代码仓后，系统会自动在代码仓中配置 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 查看代码关联结果

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

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

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

通过权限设置，分工更有序，数据更安全

在团队配置中心的团队权限里，可以配置「Pipeline」管理员。「Pipeline」产品的管理员可以管理、删除流水线，同时可以更改「Pipeline」的全局设置。

在每条流水线的流水线设置里，可以配置流水线的查看和管理权限。

作为流水线管理的 ONES Pipeline，支持集成第三方代码仓，用于监控代码仓中的特定提交事件；支持集成持续集成工具 Jenkins，用于在 ONES 管理和追踪 Jenkins 的流水线；支持研发数据自动关联整合到项目，实现研发管理闭环。

代码关联集成模块

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

流水线管理模块

通过流水线管理模块，可以进行持续集成与交付管理，并且将持续集成结果和 Project 模块结合使用。

通过流水线管理，进行持续集成与交付管理、及其和 Project 模块的结合使用。

1 启用流水线管理

Pipeline 初始页面增加使用示例。如果当前团队未关联过 Jenkins，可以在 ONES Pipeline 首页点击「开启关联 Jenkins」进入 Pipeline 配置中心关联 Jenkins，以开启流水线管理的旅程。

如果当前团队已关联过 Jenkins，可以进入 Pipeline 配置中心继续新建或编辑已关联 Jenkins。

2 关联 Jenkins

2.1 新建关联 Jenkins

前往 Pipeline 配置中心的关联 Jenkins 页面，点击「新建关联 Jenkins」以关联当前团队所需持续集成工具。系统支持 Jenkins「流水线、文件夹、多分支流水线」类型的任务。关联 Jenkins 后，你可以在「ONES Pipeline」管理和追踪此类流水线。

已关联的 Jenkins 将按列表展示。当你进入关联 Jenkins 页面时，系统会自动检测 Jenkins 的访问状态。访问失败可能的原因：Jenkins 服务器挂掉、网络问题、Jenkins 的用户或密码/Token 已变更等。

2.2 编辑关联 Jenkins

如果访问 Jenkins 的用户名或密码/Token 需要变更，你可以点击「编辑关联」按钮修改。编辑用户名或密码/Token 不会触发流水线的重新同步。

2.3.移除关联 Jenkins

如果不想在当前团队展示某个 Jenkins 的流水线，你可以点击「移除关联」按钮。移除 Jenkins 后，你将获取不到当前 Jenkins 的数据，已同步的流水线数据也将清空。

3.查看流水线

Pipeline 的流水线列表将显示不同来源的流水线，你可以根据“Jenkins URL”字段区分。

如果流水线是多分支类型，你可以根据“多分支”标签区分。系统通过父子结构展示多分支及其分支流水线。你可以通过点击“展开”查看多分支下的分支流水线。其中，分支流水线按“最近运行时间”降序排序，方便你查看最近在用的分支流水线。

在 Pipeline 首页点击流水线名称，可以查看流水线的运行历史。在 Pipeline 首页点击最近运行的 ID、或者在运行历史页点击每行运行历史记录，可以查看流水线的运行详情。‌

4.删除流水线

在流水线的更多页面里，可以删除流水线。删除流水线后，将同步删除持续集成服务器上的流水线。‌此外，如果你删除的是多分支流水线，其分支流水线也会被删除且不可恢复，请谨慎操作。

5.流水线关联业务对象

5.1 项目关联流水线

项目支持「流水线」组件。你可以进入项目设置的项目组件页面中添加。

具备项目管理员权限的用户，可以执行「关联已有流水线」的操作。此外，用户需要具备流水线的查看权限，才能看到或选到流水线。如果无相关流水线的权限，请联系流水线管理员添加。

如果你关联的是多分支流水线，其分支流水线会被自动关联到项目中。项目关联流水线后，我们就可以在项目中跟进相关的流水线运行情况。

‌5.2 迭代关联流水线运行

迭代支持「流水线运行」功能，用于展示迭代关联的流水线运行数据，你可以在此功能中追踪和分析流水线运行情况。 通常的协作流程为：

1、项目管理员需提前为项目关联流水线（在「流水线」组件 > 关联已有流水线）;

2、迭代管理员需咨询技术人员配置“迭代关联流水线运行的规则” ；

• 系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来，请根据团队需要调整。

• 默认规则「string.len(branch) > 0 and string.find(sprint_name, branch, 1, true)」表示：如果流水线运行时的分支名称 包含迭代的数据，则建立关联关系。

3、迭代管理员根据配置的“迭代关联流水线运行的规则”，修改迭代名称。

• 你需要在迭代名称中加入流水线运行的“分支名称”或“代码仓名称”；

• 以使用默认规则为例，如果期望在迭代中关联和 F2003分支 相关的流水线运行，则可以把迭代名称改成“F2003-XXX”

4、迭代成员进入「流水线运行」功能后，可以查看和迭代相关的流水线运行记录。

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

1 配置代码关联集成

1.1 新建关联代码仓

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

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

• 如果未认证过私有 GitLab，请点击「新建认证」按钮。认证私有 GitLab 需要先在 GitLab 中新建 Application，然后在 ONES 填入信息并确认认证。

• 如果你已认证过私有 GitLab，但想修改认证帐号，可以点击弹窗中的「重新认证」。

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

新建关联代码仓后，系统会自动在代码仓中配置 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 查看代码关联结果

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

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

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

通过代码关联集成 SVN（包括 Windows/Linux/Mac 系统的 SVN），将代码提交和 Project 模块结合使用。

1 配置代码关联集成

1.1 新建关联代码仓

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

1.2 配置代码关联集成

关联后，系统会引导你进入「代码仓详情」页面。你需要根据页面说明配置 SVN 的代码关联集成。配置代码关联集成包括 2 部分：配置 SVN 代码仓的 Webhook 、指定查看代码提交详情的第三方链接。

你需要先在 SVN 服务器上下载 Webhook 工具，然后选择执行命令的参数。注意：执行命令前，Windows 用户需提前准备 Python 2.7 环境。

1.2.1 配置 SVN 代码仓的 Webhook

执行的命令中，用于配置 Webhook 的必须参数：repo_dir、webhook_url、secret_key。

1.2.2 指定第三方链接查看 SVN 的代码提交详情

由于 SVN 不支持直接在浏览器查看代码提交详情，你需要借助能在浏览器中打开的第三方代码托管工具，例如 Upsource。

ONES 支持通过参数指定第三方链接，以便在 ONES 中查看工作项或迭代关联的代码提交时，能点击打开代码提交详情。如果你有此需求，可以在配置代码关联集成时选择执行参数“link_url”，否则可以不执行“link_url”参数。

1.3 移除关联代码仓

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

2 代码提交关联工作项

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

3 查看代码关联结果

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

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

此外，如果你在配置代码关联集成的时候，指定了“查看 SVN 代码提交详情”的第三方链接。你可以点击 Commit ID 查看此次代码提交的详情。 注意：系统不支持查看历史已关联的 SVN 代码提交详情。

以指定 Upsource 平台的链接为例，点击 Commit ID 打开的代码仓详情页如下图：

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