文档首页 > > 用户指南> 基于CodeHub的团队开发> 分支合并评审

分支合并评审

分享
更新时间:2020/10/19 GMT+08:00

概述

代码托管服务支持多分支开发,并为分支合并建立了可配置的审核规则,当一个开发者发起一次分支合并请求时,仓库成员都可以参与到评审中,让更多的人参与到代码审视中,以确保准合并代码的正确性。代码托管服务的分支合并评审流程如下图所示。

合并请求发起时,评审人、合并人会收到邮件、短信等提醒。

关于合并请求的相关设置

如果不做任何设置,在进行分支合并请求时将没有任何限制,这样并不安全,建议团队在使用此功能前了解相关的设置项。

合并请求设置:可配置合并请求评审的门禁分数等。

保护分支管理:可配置分支是否允许被合并。

合并请求列表

在仓库详情的“合并请求”页签中,可以看到“合并请求列表”页面。

①可以在切换查看不同状态的请求单。

②通过单击请求标题可以进入合并请求详情页,未查看过的请求会“@你”

③可以查看请求的的简要信息,包括:涉及的分支、创建时间、创建人。

④可以看到该请求目前的评论数、评审人打分情况,例如显示 ,则说明有3个指定的评审者,其中2个已经进行了打分操作,并且目前有3条评论。

⑤可以看到请求的编号,在大型团队沟通中,团队成员可以使用此编号降低沟通成本。

新建合并请求

合并请求详情

在合并请求详情页的“合并请求详情”页签。

评审者可以对合并请求进行打分操作,系统会记录评审者的打分情况,只有当前评分高于设置的门禁分数时,才能进行合并。

所有浏览者可以发表评论或者讨论。

  • 评论:只是便于参与者交流,无特殊意义。
  • 讨论:如果进行过设置,讨论必须被标注为“已解决”才能进行合并,可以手动标注为“已解决”,也可以在回复讨论内容时,选择“回复并解决”

另外,可以切换页签以查看文件的变更、提交记录、状态变更记录。

新建分支合并请求

我们假设管理员已经设置好了分支合并规则,当您在开发分支上完成了功能开发,并需要发起合并评审时,请按照以下流程操作。

  1. 进入仓库列表仓库列表。(如何创建仓库?
  2. 单击仓库名称进入仓库详情。
  3. 切换到“合并请求”页签。
  4. 单击“新建合并请求”按钮,进入“分支对比”页面,选择要合并的分支。

    如上图在本示例中我们将刚完成开发任务的branch009分支合并到master分支中。

  5. 单击“下一步”按钮,此时系统会检测两条分支是否有差异。

    • 如果没有差异,系统会做出提示,且不能新建合并请求。
    • 如果分支存在差异,则进入如下“新建合并请求”页面。

    “新建合并请求”页面的下发方可以看到两条分支的文件差异对比详情,切换到“提交记录”可以查看要合并分支的提交记录。

  6. 填写“标题”“描述”

    “描述”会结合分支合并情况与要合并分支的提交(commit)备注生成默认值,您可以团队情况进行修改。

  7. 选择“合并人”“评审人”

    • 合并人:在合并请求满足合入要求时,一般是评分高于最低准入分数、所有讨论都被解决(可设置不解决也能合并),合并人有权限执行合并操作(单击按钮)、也有权限关闭合并请求,一般是系统管理员。
    • 评审人:被指定参与合并评审,需要进行打分操作,系统会记录评审人的打分情况。

  8. 单击“确定”按钮,可以完成评审的提交,页面会跳转到该“分支合并请求详情页”

    此时如果发起者也是一个评审人,可以直接在“分支合并请求详情页”对分支合并请求进行评审

  • 当发起分支合并求情时,其相关人员(评审人、合并人)会收到提醒邮件。
  • 单个文件差异超过5000行、差异文件个数超过100个时,建议使用客户端合并后,推送到云端。

对分支合并请求进行评审与执行合入

当评审人、合并人收到系统的分支合并请求通知邮件时,请按以下步骤进行操作(以手动合并为例)。

  1. 进入仓库列表。(如何创建仓库?
  2. 单击仓库名称进入仓库详情。
  3. 切换到“合并请求”页签。
  4. (可选,如果您不是评审人,可跨过此步)对合并请求进行打分操作。

  5. (可选)可以发表评论和讨论
  6. 当分数高于门禁分数时,可以选择普通合入或删除源分支合入,操作后请求状态为“已合并”(只有合并人才能执行合并操作)。

    • 普通合入:仅进行分支合并。
    • 删除源分支合入:进行分支合并,并将已经合并的分支进行删除。

    也可以单击“关闭”,将请求关闭。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问