关于规则集

规则集是应用于一个存储库或组织中多个存储库的命名规则列表。每个存储库最多可以有 75 个规则集，以及 75 个组织范围内的规则集。

创建规则集时，可以允许某些用户绕过规则集中的规则。这可以是具有特定角色的用户（例如存储库管理员），也可以是特定团队或 GitHub Apps。有关授予旁路权限的详细信息，请参阅“创建存储库的规则集”。

对于 GitHub Enterprise 和 GitHub Team 计划的组织，可以在组织级别设置规则集，以针对组织中的多个存储库。有关详细信息，请参阅 GitHub Enterprise Cloud 文档中的“管理组织中存储库的规则集。”

你可以使用规则集针对存储库中的分支或标签，或者阻止对存储库和存储库的整个分支网络的推送。

Note

推送规则集为 beta 版本，可能会有变动。

Note

推送规则委派绕过功能目前为 beta 版本，可能随时更改。

借助推送规则集委派绕过功能，可以控制谁可以绕过推送保护以及应允许哪些被阻止的推送。

启用委派绕过后，存储库的参与者在推送包含受限内容的提交时必须请求“绕过特权”。请求将发送到指定的审阅者组，他们批准或拒绝绕过推送规则的请求。

如果绕过推送规则的请求获得批准，则参与者可以推送包含受限内容的提交。如果请求被拒绝，则参与者必须首先从包含受限内容的提交中移除相关内容，然后才能再次推送。

若要配置委派绕过，组织所有者或存储库管理员首先会创建“绕过列表”。绕过列表包括特定角色和团队，例如安全团队或存储库管理员，他们负责监督绕过推送保护的请求。有关详细信息，请参阅“管理组织中存储库的规则集”和“关于规则集”。

分支和标签规则集

可以创建规则集来控制用户如何与存储库中的选定分支和标记交互。可以控制谁可以将提交推送到特定分支以及提交的格式必须如何设置，或者谁可以删除或重命名标记。例如，可以为存储库的 feature 分支设置一个规则集，针对除存储库管理员以外的所有用户要求签名提交和阻止强制推送。

对于创建的每个规则集，可以指定将规则集应用于存储库中的哪些分支或标记，或组织中的哪些存储库，。可以使用 fnmatch 语法定义一种模式，用于面向特定的分支、标记和存储库。例如，可以使用 releases/**/* 模式来面向存储库中名称以字符串 releases/ 开头的所有分支。有关 fnmatch 语法的详细信息，请参阅“创建存储库的规则集”。

推送规则集

Note

推送规则集为 beta 版本，可能会有变动。

使用推送规则集，可以阻止对专用或内部存储库的推送，以及对此存储库整个分支网络的推送，具体取决于文件扩展名、文件路径长度、文件和文件夹路径以及文件大小。

推送规则不需要针对任何分支，因为它们会应用于对存储库的每条推送。

推送规则集允许你：

限制文件路径：阻止推送包含指定文件路径更改的提交。

可以为此使用 fnmatch 语法。例如，针对 test/demo/**/* 的限制可阻止对 test/demo/ 目录中的文件或文件夹进行任何推送。针对 test/docs/pushrules.md 的限制可阻止对 pushrules.md 目录中 test/docs/ 文件的专门推送。有关详细信息，请参阅“创建存储库的规则集”。
限制文件路径长度：阻止推送包含超过指定字符限制的文件路径的提交。
限制文件扩展名：阻止推送包含具有指定文件扩展名的文件的提交。
限制文件大小：阻止推送超过指定文件大小限制的提交。

关于向已创建分支的存储库推送规则集

推送规则适用于存储库的整个分支网络，以确保存储库的每个入口点均受到保护。例如，如果将已启用推送规则集的存储库创建为分支，则相同的推送规则集也适用于已创建分支的存储库。

对于已创建分支的存储库，只有对推送规则具有旁路权限的人员是根存储库中具有旁路权限的人员。