管理分支保护规则

关于分支保护规则

您可以在仓库中为特定分支、所有分支或者与使用 fnmatch 语法指定的命名模式匹配的任何分支创建分支保护规则。例如，要保护包含文字 release 的任何分支，您可以为 *release* 创建分支规则。

您还可以使用通配符语法 * 为仓库中的所有当前和未来分支创建规则。由于 GitHub 对 File.fnmatch 语法使用 File::FNM_PATHNAME 标记，因此通配符与目录分隔符 (/) 不匹配。例如，qa/* 将匹配以 qa/ 开头并包含单个斜杠的所有分支。您可以通过 qa/**/* 包含多个斜杠，也可以通过 qa**/**/* 扩展 qa 字符串，使规则更具包容性。有关分支规则语法选项的更多信息，请参阅 fnmatch 文档。

如果仓库有多个影响相同分支的受保护分支规则，则包含特定分支名称的规则具有最高优先级。如果有多个受保护分支规则引用相同的特定规则名称，则最先创建的分支规则优先级更高。

提及特殊字符（如 *、? 或 ]）的受保护分支按其创建的顺序应用，因此含有这些字符的规则创建时间越早，优先级越高。

要创建对现有分支规则的例外，您可以创建优先级更高的新分支保护规则，例如针对特定分支名称的分支规则。

有关每个可用分支保护设置的更多信息，请参阅“关于受保护分支”。

创建分支保护规则

创建分支规则时，指定的分支不必是仓库中现有的分支。

在 GitHub Enterprise Server 上，导航到仓库的主页面。
在仓库名称下，单击 Settings（设置）。
在左侧菜单中，单击 Branches（分支）。
在“Branch protection rules（分支保护规则）”旁边，单击 Add rule（添加规则）。
在“Branch name pattern（分支名称模式）”下，输入您要保护的分支名称或模式。
（可选）启用必需拉取请求审查。
- 在“Protect matching branches（保护匹配分支）”下，选择 Require pull request reviews before merging（合并前必需拉取请求审查）。
- 单击 Required approving reviews（必需批准审查）下拉菜单，然后选择要对分支要求的批准审查数量。
- （可选）要在将代码修改提交推送到分支时忽略拉取请求批准审查，请选择 Dismiss stale pull request approvals when new commits are pushed（推送新提交时忽略旧拉取请求批准）。
- （可选）要在拉取请求影响具有指定所有者的代码时要求代码所有者审查，请选择 Require review from Code Owners（需要代码所有者审查）。更多信息请参阅“关于代码所有者”。
- （可选）如果仓库属于组织，请选择 Restrict who can dismiss pull request reviews（限制谁可以忽略拉取请求审查）。然后，搜索并选择有权忽略拉取请求审查的人员或团队。更多信息请参阅“忽略拉取请求审查”。
（可选）启用必需状态检查。
- 选中 Require status checks to pass before merging（合并前必需状态检查通过）。
- （可选）要确保使用受保护分支上的最新代码测试拉取请求，请选择 Require branches to be up to date before merging（要求分支在合并前保持最新）。
- 从可用状态检查列表中，选择您想要设为必需的检查。
（可选）选择 Require signed commits（必需签名提交）。
（可选）选择 Require linear history（必需线性历史记录）。
视情况可选择 Include administrators（包括管理员）。
（可选）启用分支限制。
- 选择 Restrict who can push to matching branches（限制谁可以推送到匹配分支）。
- 搜索并选择有权限推送到受保护分支的人员、团队或应用程序。
（可选）在“Rules applied to everyone including administrators（适用于包括管理员在内的所有人规则）”下，选择 Allow force pushes（允许强制推送）。
（可选）选择 Allow deletions（允许删除）。
单击 Create（创建）。