控制对较大运行器的访问

可以使用策略来限制对已添加到组织或企业的大型运行器的访问。

谁可以使用此功能？

大型运行器目前仅对使用 GitHub Team 或 GitHub Enterprise Cloud 计划的组织和企业可用。

Note

本文中的信息和说明仅适用于使用 Linux 和 Windows 操作系统的大型运行器。

要在组织级别，使用 GitHub Team 计划的组织可以使用运行器组。运行器组用于收集运行器集，并围绕它们创建安全边界。

授予对运行器组的访问权限时，可以看到组织的运行器设置中列出的运行器组。或者，你可以为运行器组分配更精细的存储库访问策略。

在创建新运行器时，除非另有指定，否则它们将自动分配给默认组。运行器每次只能在一个组中。可以将运行器从一个运行器组移动到另一个运行器组。有关详细信息，请参阅“将运行器移动到组”。

有关如何将作业路由到特定组中的运行器的信息，请参阅“选择作业的运行器”。

Note

必须先为运行器组配置权限，然后工作流才能将作业发送到大型运行器。有关详细信息，请参阅下列各节。

运行器组用于控制哪些存储库可以在大型运行器上运行作业。必须从管理层次结构的各个级别管理对组的访问，具体取决于定义大型运行器的位置：

企业级运行器：默认情况下，组织中的存储库无权访问企业级运行器组。若要向存储库授予对企业运行器组的访问权限，组织所有者必须配置每个企业运行器组，并选择要授予访问权限的存储库。
组织级运行器：默认情况下，向组织中的所有存储库授予对组织级运行器组的访问权限。若要限制哪些存储库具有访问权限，组织所有者必须配置组织运行器组并选择哪些存储库具有访问权限。

例如，下图包含一个企业级别的名为 grp-ubuntu-20.04-16core 的运行器组。在名为 octo-repo 的存储库可以使用该组中的运行器之前，必须先在企业级别配置该组以允许访问 octo-org 组织。然后必须在组织级别配置该组以允许访问 octo-repo。

关系图，显示了在企业级定义的运行器组，其组织配置可允许访问两个存储库。

Warning

如果使用固定 IP 范围，建议仅对专用存储库使用大型运行器。公共存储库的分支可能会通过创建在工作流中执行代码的拉取请求，在大型运行器上运行危险代码。

Note

创建运行器组时，你必须选择一个策略，用于定义哪些存储库有权访问运行器组。若要更改哪些存储库和工作流可以访问运行器组，组织所有者可以为组织设置策略。有关详细信息，请参阅“在企业中为 GitHub Actions 实施策略”。

所有组织都有单个默认运行器组。使用 GitHub Team 计划的组织所有者可以创建其他组织级运行器组。

如果在注册过程中未指定任何组，则运行器会自动添加到默认组。稍后可以将运行器从默认组移动到自定义组。有关详细信息，请参阅“将运行器移动到组”。

有关如何使用 REST API 创建运行器组的信息，请参阅“GitHub Actions 的 REST API 终结点”。

在 GitHub 上，导航到组织的主页面。
在组织名称下，单击 “设置”****。如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。
在左侧边栏中，单击 “操作”，然后单击“运行器组” 。
在“运行器组”部分，单击“新建运行器组”。
为运行器组输入名称。
分配存储库访问策略。

你可以将运行程序组配置为可供特定存储库列表或组织中的所有存储库访问。默认情况下，只有专用存储库可以访问运行程序组中的运行程序，但你可以覆盖此设置。如果配置企业共享的组织的运行组，则不能覆盖此设置。
单击“创建组”以创建组并应用策略。