代码托管 CODEARTS REPO-合并请求管理:新建合并请求
新建合并请求
假设管理员已经设置好了分支合并规则,当您在开发分支上完成了功能开发,并需要发起合并请求时,请按照以下流程操作。
- 进入目标仓库详情页。
- 切换到“合并请求”页签。
- 单击“新建”按钮,选择要合并的分支。
如上图在本示例中将刚完成开发任务的Dev分支合并到master分支中。
支持源分支选择Fork仓库的分支。
- 单击“下一步”按钮,此时系统会检测两条分支是否有差异。
- 如果分支没有差异,系统会做出提示,且不能新建合并请求。
- 如果分支存在差异,则进入“新建合并请求”页面。
在“新建合并请求”页面的下方可以看到两条分支的文件差异对比详情、要合并分支的提交记录。
- 根据下表参数说明,填写页面信息。
表1 参数说明 参数
说明
更改分支
单击可返回上一步更改需要合并的分支。
模板
如果仓库管理员或所有者已为该仓库创建合并请求模板,您可以直接选择使用模板。
标题
输入合并请求的标题。
描述
会结合分支合并情况与要合并分支的提交(commit)备注生成默认值,您可以根据项目情况进行修改。
说明:该输入框采用markdown格式,字符数限制在5000字符以内,即将超出上限时,使用顶部的操作按钮会按照markdown的语法替换内容。
关联工作项
可选择将合并动作关联到某个工作项,以起到自动改变工作项状态的作用。
合并人
在合并请求满足合入要求时,一般是所有审核人审核通过、所有问题都被解决(可设置不解决也能合并),合并人有权限执行合并操作(单击按钮)、也有权限关闭合并请求。
检视人
被指定参与合并分支检视,可以提出问题给发起人。
审核人
被指定参与合并分支评审,可以给出审核意见(审核通过、拒绝),也可以提出问题给发起人。
合并后删除源分支
可选择是否合并后删除源分支,初始会带入合并请求设置中预设状态。
Squash合并
开启Squash合并,可使基本分支的历史记录保持干净,并带有有意义的提交消息,而且在必要时可以更简单地恢复,详情请参考Squash合并。
- 单击“新建合并请求”按钮,可以完成合并请求的提交,页面会跳转到该“合并请求详情页”。
在合并请求详情中,可以看到合入条件达成的状态、合并人、检视人、审核人、所关联的工作项等信息,同时可以查看可留下评审意见,可标注评审意见为待解决状态,并可看到该合并涉及的所有动态。
- “提交记录”:可以看到源分支的相关提交记录。
- “文件变更”:可以看到此次合并的变更内容,并可具体筛选出新增、修改、删除、重命名等变更种类。
- “流水线”:可以看到门禁流水线的信息。
- 当发起分支合并请求时,其相关人员(审核人、合并人)会收到提醒邮件。审核人不能为合并请求创建者。
- 单个文件差异超过5000行、差异文件个数超过100个时,建议使用客户端合并后,推送到代码托管。
- 新建合并请求后自动跳转到合并请求页,只有流水线正在排队或者运行中,而合并请求其他合入条件都通过时,有合入权限成员可勾选“合并请求流水线成功后自动合入”。