关联私有 Bitbucket 前,请确保 ONES 系统和贵司 Bitbucket 网络能互联互通。
推荐使用 Bitbucket 6.0 以上版本,低于6.0版本不保证完全支持。
新建关联私有部署 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 中的工作项、迭代进行关联。
关联私有 GitLab 前,请确保 ONES 系统和贵司 GitLab 网络能互联互通。
私有 GitLab 版本最低支持 11.11.x,推荐使用 12.4.x。其他版本可能存在兼容性问题,例如导致系统无法自动配置代码仓的 Webhook,需要你手工在代码仓中配置
前往 Pipeline 配置中心的代码仓管理页面,点击「新建关联代码仓」以关联当前团队所需私有 GitLab 代码仓。
通过 OAuth 的方式认证私有 GitLab,以便系统能获取自动配置代码仓 Webhook 的权限。
如果未认证过私有 GitLab,请点击「新建认证」按钮。认证私有 GitLab 需要先在 GitLab 中新建 Application,然后在 ONES 填入信息并确认认证。
如果你已认证过私有 GitLab,但想修改认证帐号,可以点击弹窗中的「重新认证」。
OAuth 认证成功后,你需要选择代码仓并完成新建关联代码仓。
目前系统最多能获取到私有 GitLab 的 100 个代码仓。如果希望关联 100 以上个代码仓,你需要将代码仓划分到不同的私有 GitLab 帐号中进行关联。
如果希望关联多个私有 GitLab 服务器,你需要联系不同的 ONES 用户分开进行认证和关联。
操作关联的用户在私有 GitHub 中至少具有「Maintainor」权限,否则系统无权限自动配置代码仓的 Webhook,你需要手工配置。
新建关联代码仓后,系统会自动在代码仓中配置 Webhook。你可以在代码仓详情中检查 Webhook 的配置状态。
Webhook 用于允许 ONES 监听代码平台上的特定提交事件。新建关联代码仓后,你可以通过以下方式重新配置 Webhook。
系统自动重置 Webhook 如果 Webhook 失效或被人为删除,你可以点击「重置 Webhook」按钮,系统会自动重置代码仓中的 Webhook。
手工配置 Webhook 点击「手工配置 Webhook」按钮,你可以查看当前代码仓的 Webhook 的配置信息,再进入 Git 平台中手工添加 Webhook。
如果不需要再获取某代码仓的代码提交数据,你可以移除关联此代码仓。 移除关联代码仓不影响历史已获取的代码提交数据。
团队成员可以在代码提交 (commit message) 的时候通过输入包含工作项 ID 的方式和工作项进行关联。 目前一次代码提交支持与多个工作项同时进行绑定,请在多个工作项 ID 之间添加空格作为分隔,例如“#1 工作项一 #2 工作项二”。
需求自动关联代码提交及其触发的持续集成数据,以便代码提交数据与项目管理结合。你可以在工作项详情的“代码关联”栏位查看代码关联结果。
迭代支持汇总需求已关联的代码提交数据,迭代负责人可以据此跟进开发进展。
迭代概览下将汇总统计当前迭代的代码提交情况,帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。
SVN 服务端版本最低支持 Subversion 1.7.x,推荐使用 Subversion 1.10.x。请对应选择客户端版本,客户端推荐使用 TortoiesSVN 1.13.x。
前往 Pipeline 配置中心的代码仓管理页面,点击「新建关联代码仓」以关联当前团队所需 SVN 代码仓。
关联后,系统会引导你进入「代码仓详情」页面。你需要根据页面说明配置 SVN 的代码关联集成。配置代码关联集成包括 2 部分:配置 SVN 代码仓的 Webhook 、指定查看代码提交详情的第三方链接。
你需要先在 SVN 服务器上下载 Webhook 工具,然后选择执行命令的参数。注意:执行命令前,Windows 用户需提前准备 Python 2.7 环境。
执行的命令中,用于配置 Webhook 的必须参数:repo_dir、webhook_url、secret_key。
由于 SVN 不支持直接在浏览器查看代码提交详情,你需要借助能在浏览器中打开的第三方代码托管工具,例如 Upsource。
ONES 支持通过参数指定第三方链接,以便在 ONES 中查看工作项或迭代关联的代码提交时,能点击打开代码提交详情。如果你有此需求,可以在配置代码关联集成时选择执行参数“link_url”,否则可以不执行“link_url”参数。
如果不需要再获取某代码仓的代码提交数据,你可以移除关联此代码仓。 移除关联代码仓不影响历史已获取的代码提交数据。
团队成员可以在代码提交 (commit message) 的时候通过输入包含工作项 ID 的方式和工作项进行关联。 目前一次代码提交支持与多个工作项同时进行绑定,请在多个工作项 ID 之间添加空格作为分隔,例如“#1 工作项一 #2 工作项二”。
需求自动关联代码提交,以便代码提交数据与项目管理结合。你可以在工作项详情的“代码关联”栏位查看代码关联结果。
迭代支持汇总需求已关联的代码提交数据,迭代负责人可以据此跟进开发进展。
此外,如果你在配置代码关联集成的时候,指定了“查看 SVN 代码提交详情”的第三方链接。你可以点击 Commit ID 查看此次代码提交的详情。 注意:系统不支持查看历史已关联的 SVN 代码提交详情。
以指定 Upsource 平台的链接为例,点击 Commit ID 打开的代码仓详情页如下图:
迭代概览下将汇总统计当前迭代的代码提交情况,帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。
如果你使用的是 ONES 私有部署版,请联系客服。ONES 的技术人员将为你准备基础配置,以便于能正常关联 GitHub/GitLab 代码仓。
前往 Pipeline 配置中心的代码仓管理页面,点击「新建关联代码仓」以关联当前团队所需 GitHub/GitLab 代码仓。
通过 OAuth 的方式认证 GitHub/GitLab,以便系统能获取自动配置代码仓 Webhook 的权限。
如果未认证过 GitHub/GitLab,请点击「新建认证」按钮;在打开的 GitHub/GitLab 平台的界面中确认授权认证 ONES;授权认证 ONES 成功后,系统会引导你回到 ONES 系统。
如果你已认证过 GitHub/GitLab,但想修改认证帐号,请在浏览器的无痕模式下点击弹窗中的「重新认证」,登录新帐号并重新认证后,系统会引导你回到 ONES 系统。
OAuth 认证成功后,你需要选择代码仓并完成新建关联代码仓。
目前系统最多能获取到 GitHub/GitLab 的 100 个代码仓。如果希望关联 100 以上个代码仓,你需要将代码仓划分到不同的 GitHub/GitLab 帐号中进行关联。
操作关联的用户在 GitHub 中至少具有「Owner」权限、在 GitLab 中至少具有「Maintainor」权限,否则系统无权限自动配置代码仓的 Webhook,你需要手工配置。
新建关联代码仓后,系统会自动在代码仓中配置 Webhook。你可以在代码仓详情中检查 Webhook 的配置状态。
Webhook 用于允许 ONES 监听代码平台上的特定提交事件。新建关联代码仓后,你可以通过以下方式重新配置 Webhook。
系统自动重置 Webhook 如果 Webhook 失效或被人为删除,你可以点击「重置 Webhook」按钮,系统会自动重置代码仓中的 Webhook。
手工配置 Webhook 点击「手工配置 Webhook」按钮,你可以查看当前代码仓的 Webhook 的配置信息,再进入 Git 平台中手工添加 Webhook。
如果不需要再获取某代码仓的代码提交数据,你可以移除关联此代码仓。 移除关联代码仓不影响历史已获取的代码提交数据。
团队成员可以在代码提交 (commit message) 的时候通过输入包含工作项 ID 的方式和工作项进行关联。 目前一次代码提交支持与多个工作项同时进行绑定,请在多个工作项 ID 之间添加空格作为分隔,例如“#1 工作项一 #2 工作项二”。
需求自动关联代码提交及其触发的持续集成数据,以便代码提交数据与项目管理结合。你可以在工作项详情的“代码关联”栏位查看代码关联结果。
迭代支持汇总需求已关联的代码提交数据,迭代负责人可以据此跟进开发进展。
迭代概览下将汇总统计当前迭代的代码提交情况,帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。