管理存储库的规则集

创建规则集之后，可以对其进行更改。例如，可以添加规则以更好地保护分支或标签，也可以在测试规则集对存储库的参与者体验产生的影响后将规则集从“评估”模式切换到“活动”模式。

可以使用 REST API 和 GraphQL API 来管理规则集。有关详细信息，请参阅“规则的 REST API 终结点”和“突变”。

提示：如果你是组织的所有者，则可以在组织级别创建规则集。可以将这些规则集应用于组织中的特定存储库，以及这些存储库中的特定分支。有关详细信息，请参阅“创建组织中存储库的规则集”。

查看存储库的规则集

在“规则集”页面上，对存储库具有读取访问权限的任何人都可以查看针对特定分支、标记或推送限制的有效规则集。你还将看到在“评估”模式下运行的规则集，这些规则集未强制实施。

对于已创建分支的存储库的推送规则集，“规则集”页面将指示规则集由应用规则的源存储库管理。

注意：如果规则集是在组织级别创建的，则无法从存储库的设置中编辑规则集。如果你有权编辑规则集，则可以在组织的设置中执行此操作。有关详细信息，请参阅“管理组织中存储库的规则集”。

可以通过编辑规则集更改规则集的某些部分，例如名称、绕过权限或规则。还可以编辑规则集更改其状态，例如在需要启用或暂时禁用规则集时。

提示：如果要暂时禁用某个规则集，但不想将其删除，可以将规则集的状态设置为“已禁用”。有关详细信息，请参阅“编辑规则集”。

Note

可以查看规则集的所有更改并还原回特定迭代。还可以在特定迭代中下载包含规则集配置的 JSON 文件。规则集的绕过列表已从导出的 JSON 文件中排除。

在 GitHub 上，导航到存储库的主页面。
在存储库名称下，单击 “设置”。如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
在左侧边栏的“代码和自动化”下，单击“规则”，然后单击“规则集” 。
要查看规则集更改历史记录，在规则集名称右侧选择，然后单击“ 历史记录”****。
在特定迭代右侧选择 % octicon "kebab-horizontal" aria-label="Open additional options" %}，然后单击“比较更改”、“还原” 或“下载”****。

可以使用 JSON 文件从另一个存储库或组织导入规则集。如果要将相同规则集应用于多个存储库或组织，这种方法很有用。

可以查看规则集的见解，了解规则集如何影响存储库。在“规则见解”页面上，会看到以下用户操作的时间线。可以使用筛选器来查找要查找的内容。

如果规则集在“评估”模式下运行，则可以看到规则集处于活动状态时会通过或失败的操作。

“规则见解”页面的屏幕截图。列出了三个操作：一个标记为“通过”，一个标记为“绕过”，一个标记为“失败”并带有“评估”标签。

Note

推送规则委派绕过目前为公共预览版，可能随时更改。

可以在存储库的规则设置下的“推送请求”页面上查看和管理所有绕过特权请求。

可以按审批者（绕过列表的成员）、请求者（发出请求的参与者）、时间范围和状态来筛选请求。将为请求分配以下状态：

当参与者请求绕过特权来推送包含受限内容的提交时，绕过列表的成员都会收到一个电子邮件通知，其包含请求的链接。然后，绕过列表的成员有 7 天的时间审查请求，并在请求过期之前批准或拒绝请求。

参与者会通过电子邮件通知该决定，必须采取所需的操作。如果请求获得批准，则参与者可以将包含受限内容的提交推送到存储库。如果请求被拒绝，则参与者必须从提交中移除受限内容后才能成功地将提交推送到存储库。