创建规则集之后,可以对其进行更改。 例如,可以添加规则以更好地保护分支或标签,也可以在测试规则集对存储库的参与者体验产生的影响后,暂时禁用规则集,以排查对存储库参与者体验产生的任何意外影响 。
可以使用 REST API 和 GraphQL API 来管理规则集。 有关详细信息,请参阅“规则的 REST API 终结点”和“突变”。
查看存储库的规则集
在“规则集”页面上,对存储库具有读取访问权限的任何人都可以查看针对特定 分支、标签或推送限制的有效规则集。
对于已创建分支的存储库的推送规则集,“规则集”页面将指示规则集由应用规则的源存储库管理。
-
在 GitHub 上,导航到存储库的主页面。
-
在左侧的文件树视图中,选择 分支下拉菜单,然后单击“查看所有分支”。 还可以在集成的文件编辑器顶部找到分支下拉菜单。
-
在分支名称的左侧,单击 。
-
(可选)若要筛选结果,请单击选项卡,或使用“搜索分支”搜索栏。
-
单击要查看的规则集的名称。
编辑规则集
可以通过编辑规则集更改规则集的某些部分,例如名称、绕过权限或规则。 还可以编辑规则集更改其状态,例如在需要启用或暂时禁用规则集时。
-
在 GitHub 上,导航到存储库的主页面。
-
在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。
-
在左侧边栏的“代码和自动化”下,单击“规则”,然后单击“规则集” 。
-
在“规则集”页面上,单击要编辑的规则集的名称。
-
根据需要更改规则集。 有关可用规则的信息,请参阅“规则集的可用规则”。
-
在页面的底部,单击“保存更改”。
删除规则集
提示:如果要暂时禁用某个规则集,但不想将其删除,可以将规则集的状态设置为“已禁用”。 有关详细信息,请参阅“编辑规则集”。
-
在 GitHub 上,导航到存储库的主页面。
-
在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。
-
在左侧边栏的“代码和自动化”下,单击“规则”,然后单击“规则集” 。
-
单击要删除的规则集的名称。
-
在规则集名称右侧,选择 ,然后单击“ 删除规则集”。
使用规则集历史记录
注意:
- 规则集历史记录目前为公共 beta 版本,可能会有变动。
- 规则集历史记录仅包含 2023 年 10 月 11 日公开 beta 版本之后对规则集所做更改。
可以查看规则集的所有更改并还原回特定迭代。 还可以在特定迭代中下载包含规则集配置的 JSON 文件。 规则集的绕过列表已从导出的 JSON 文件中排除。
-
在 GitHub 上,导航到存储库的主页面。
-
在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。
-
在左侧边栏的“代码和自动化”下,单击“规则”,然后单击“规则集” 。
-
要查看规则集更改历史记录,在规则集名称右侧选择 ,然后单击“ 历史记录”****。
-
在特定迭代右侧选择 % octicon "kebab-horizontal" aria-label="Open additional options" %},然后单击“比较更改”、“还原” 或“下载”****。
导入规则集
可以使用 JSON 文件从另一个存储库或组织导入规则集。 如果要将相同规则集应用于多个存储库或组织,这种方法很有用。
-
在 GitHub 上,导航到存储库的主页面。
-
在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。
-
在左侧边栏的“代码和自动化”下,单击“规则”,然后单击“规则集” 。
-
选择“新建规则集”**** 下拉列表,然后单击“导入规则集”****。
-
打开导出的 JSON 文件。
-
查看导入的规则集,然后单击“创建”****。