合并请求

合并请求 (MR) 是源代码更改进入到分支中的方式。 当您打开合并请求时,您可以在合并之前对代码更改进行可视化和协作。 合并请求包括:

  • 请求的描述。
  • 代码更改和内联代码审查。
  • 有关 CI/CD 流水线的信息。
  • 讨论主题的评论部分。
  • 提交列表。

首先,阅读合并请求简介

查看合并请求

您可以查看您的项目、群组或您自己的合并请求。

查看项目的合并请求

查看项目的所有合并请求:

  1. 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
  2. 在左侧边栏上,选择 合并请求

或者,要使用键盘快捷键,请按 g + m

查看群组中所有项目的合并请求

查看群组中所有项目的合并请求:

  1. 在顶部栏上,选择 菜单 > 群组 并找到您的群组。
  2. 在左侧边栏上,选择 合并请求

如果您的群组包含子组,此视图还会显示来自子组项目的合并请求。

查看分配给您的所有合并请求

查看分配给您的所有合并请求:

  1. 在顶部栏上,将光标放在 搜索 框中。
  2. 从下拉列表中,选择 指派给我的合并请求

或者,要使用键盘快捷键,请按 Shift + m

您可以搜索和过滤结果,或选择合并请求以开始审核。

向合并请求添加更改

如果您有权向合并请求添加更改,则可以通过多种方式将更改添加到现有合并请求,具体取决于更改的复杂性以及您是否需要访问开发环境:

  • 在浏览器中使用 . 键盘快捷键,在 Web IDE 中编辑更改。使用这种基于浏览器的方法来编辑多个文件,或者如果您对 Git 命令不满意。您不能从 Web IDE 运行测试。
  • 如果您需要一个功能齐全的环境来编辑文件,然后运行测试,在 Gitpod 编辑更改。Gitpod 支持运行 GitLab Development Kit (GDK)。要使用 Gitpod,您必须在您的用户帐户中启用 Gitpod。
  • 如果您熟悉 Git 和命令行,从命令行推送更改

请求关注合并请求

引入于 14.10 版本,功能标志名为 mr_attention_requests。默认禁用。

要告诉合并请求的指派人或审核者需要他们关注合并请求,您可以请求他们关注。如果指派人或审核者在合并请求上被请求关注,则合并请求列表页面上的 关注请求 图标 () 将显示为实心图标 ():

Attention request icon

查看需要您关注的合并请求列表:

  1. 在顶部栏上,选择 合并请求 ()。
  2. 选择 关注请求

要请求其他用户关注,请使用 /attention @user 快速操作 或:

  1. 进入合并请求。
  2. 在右侧边栏上,确定您要请求关注的用户。
  3. 在用户名旁边,选择 请求关注 (),图标的外观发生变化:

    Attention request toggle

删除关注请求

如果您被请求关注作为指派人或审核者,当您进行以下操作时删除关注请求:

  • 通过选择 删除关注请求 () 手动删除关注请求。
  • 批准合并请求。
  • 添加新用户作为指派人或审核者。
  • 请求其它指派人或审核者的注意。
  • 将自己的指派人或审核者身份删除(或被其他人删除)。
  • 合并或关闭合并请求。

如果您既是合并请求的指派人又是审核者,您只会收到一个关注请求,该请求在两个职责之间同步。如果从您那里删除请求,无论是作为指派人或审核者,则从您的两个职责中都删除。

关闭合并请求

如果您决定永久停止处理合并请求,建议您关闭合并请求而不是删除它。合并请求的作者和指派人,项目中具有开发者、维护者或拥有者角色的用户可以关闭项目中的合并请求:

  1. 转到您要关闭的合并请求。
  2. 滚动到页面底部的评论框。
  3. 在评论框之后,选择 关闭合并请求

极狐GitLab 关闭合并请求,但保留合并请求、其注释和任何相关流水线的记录。

删除合并请求

建议您关闭而不是删除合并请求。

caution您无法撤消对合并请求的删除。

要删除合并请求:

  1. 以项目所有者角色的用户身份登录极狐GitLab。只有具有此角色的用户才能删除项目中的合并请求。
  2. 前往您要删除的合并请求,然后选择 编辑
  3. 滚动到页面底部,然后选择 删除合并请求

合并请求工作流

对于在团队中工作的软件开发人员:

  1. 您检出一个新分支,并通过合并请求提交您的更改。
  2. 您从团队收集反馈。
  3. 您使用代码质量报告处理实现优化代码。
  4. 您使用 GitLab CI/CD 中的单元测试报告验证您的更改。
  5. 您避免使用许可证与您项目的许可证合规报告不兼容的依赖项。
  6. 您向您的经理请求核准
  7. 您的经理:
    1. 使用他们的最终审核推送提交。
    2. 核准合并请求
    3. 设置为流水线成功时合并
  8. 使用 GitLab CI 的手动作业将您的更改部署到生产环境中。
  9. 您的实施已成功交付给您的客户。

对于为您公司的网站编写网页的 Web 开发人员:

  1. 您检出一个新分支并通过合并请求提交一个新页面。
  2. 您从审核者那里收集反馈。
  3. 您可以使用 Review Apps 预览您的更改。
  4. 您要求您的网页设计师实现。
  5. 您向您的经理请求核准
  6. 一旦获得核准,您的合并请求将被压缩和合并,并通过 GitLab Pages 部署到 staging。
  7. 您的生产团队拣选合并提交到生产环境中。