Skip to main content

管理合并队列

您可以通过存储库中拉取请求的合并队列来加快开发速度。

People with admin permissions can manage merge queues for pull requests targeting selected branches of a repository.

注意: 拉取请求合并队列功能目前处于有限公测阶段,可能会发生更改。 组织所有者可以通过加入等待列表来请求提前访问测试版。

关于合并队列

合并队列可以提高将拉取请求合并到繁忙的目标分支中的速率,同时确保所有必需的分支保护检查都通过。

拉取请求通过所有必需的分支保护检查后,对存储库具有写入访问权限的用户可以将该拉取请求添加到合并队列中。

合并队列可以使用 GitHub Actions。 更多信息请参阅“GitHub Actions”。

合并队列创建具有特殊前缀的临时分支,以验证拉取请求更改。 然后,拉取请求中的更改将与最新版本的 base_branch 以及队列中位于其前面的更改组合。 GitHub 将在 base_branch 的分支保护所需的检查通过后,将所有这些更改合并到 base_branch 中。

您可能需要更新持续集成 (CI) 配置,以便在创建组后触发以特殊前缀 gh-readonly-queue/{base_branch} 开头的分支名称的构建。

例如,使用 GitHub Actions,每当面向基本分支 main 的拉取请求排队等待合并时,都会运行具有以下触发器的工作流程。

on:
  push:
    branches:
    - gh-readonly-queue/main/**

GitHub merges the pull request according to the merge strategy configured in the branch protection once all required CI checks pass.

合并队列合并方法

有关合并方法的信息,请参阅“关于拉取请求合并”。

注:

  • 不可对在分支名称模式中使用通配符 (*) 的分支保护规则启用合并队列。

将拉取请求与目标分支的最新版本分组并在队列中更改后,如果所需的状态检查失败或与基本分支发生冲突,GitHub 将从队列中删除拉取请求。 拉取请求时间线将显示从队列中删除拉取请求的原因。

管理合并队列

存储库管理员可以通过在基本分支的保护规则中启用分支保护设置“需要合并队列”来要求合并。

有关如何启用合并队列保护设置的信息,请参阅“管理分支保护规则”。

延伸阅读