极狐 GitLab

合并请求概念

以下文档是关于合并请求术语和功能的唯一真实来源。

合并请求由几个不同的关键组件和理念组成,涵盖了整体的合并请求体验。这些概念有时术语相互矛盾或令人困惑,或与其他概念重叠。本页面涵盖以下概念:

  1. 合并微件
  2. 报告微件
  3. 合并检查
  4. 审批规则

在开发新的合并请求微件时,请阅读 合并请求微件框架 文档。所有新的微件均应使用此框架,旧的微件也应 迁移至此框架。

合并微件#

合并微件是合并请求中包含 合并 按钮的组件:

合并微件显示合并前必须满足的合并要求。

合并请求的此区域定义了合并前的所有选项和提交信息。它还包含有关合并请求中包含的内容、关闭了哪些议题以及对合并流程重要的其他信息。

报告微件#

报告是合并请求中的微件,用于报告合并请求内更改的相关信息。这些微件提供信息,帮助作者更好地理解更改以及对提议更改的进一步改进。

设计文档

报告微件显示合并请求的流水线、审批和质量检查结果。

合并检查#

合并检查是一种可以“通过”或“失败”的状态,并有条件地控制合并请求中“合并”按钮是否可用。合并检查的主要区别在于,用户不会在合并请求中与合并检查进行交互,但可以影响检查是通过还是失败。检查的结果以真/假进行处理,以确定是否可以合并合并请求。

合并检查的示例包括:

只有当所有必需的合并检查都得到满足时,才能合并合并请求。

审批#

审批规则根据某种组织策略指定必须或可以选择审批合并请求的用户。当需要审批时,它们实际上成为了必需的合并检查。合并检查与审批规则之间的主要区别在于,用户会通过决定是否批准合并请求来与审批规则进行交互。

此外,审批设置提供了配置选项,以定义这些审批规则在合并请求中如何应用。它们可以设置限制、添加要求或修改审批。

审批规则和设置的示例包括: