Skip to main content

管理较大的运行器

你可以为你的组织或企业配置 大型运行器。

谁可以使用此功能

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

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

将 大型运行器 添加到组织

可以将 大型运行器 添加到组织,其中的组织所有者可以控制哪些存储库可以使用它。 为组织创建新运行器时,默认情况下,组织中的所有存储库都有权访问运行器。 若要限制哪些存储库可以使用运行器,请将其分配给有权访问特定存储库的运行器组。 有关详细信息,请参阅“允许存储库访问运行器组”。

可以从可用选项列表中选择操作系统和硬件配置。 通过自动缩放部署此运行器的新实例时,它们会使用此处定义的相同操作系统和硬件配置。

新运行器会自动分配给默认组,也可以在运行器创建过程中选择运行器必须加入的组。 此外,可以在注册运行器后修改运行器组成员身份。 有关详细信息,请参阅“控制对较大运行器的访问”。

  1. 在 GitHub.com 上,导航到组织的主页。

  2. 在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

  4. 单击“新建运行器”,然后单击“ 新建 GitHub 托管的运行器” 。

  5. 完成配置新运行器所需的详细信息:

    • 名称:输入新运行器的名称。 为了便于识别,这应指示其硬件和操作配置,例如 ubuntu-20.04-16core
    • 运行器映像:从可用选项中选择操作系统。 选择操作系统后,便能够选择特定版本。
    • 运行器大小:从可用选项下拉列表中选择硬件配置。
    • 自动缩放:选择可随时处于活动状态的最大作业数。
    • 运行器组:选择运行器所属的组。 此组会托管运行器的多个实例,因为它们会纵向扩展和缩减以满足需求。
  6. 单击“创建运行器”。

  7. 若要允许存储库访问 大型运行器,请将它们添加到可以使用它的存储库列表中。 有关详细信息,请参阅“允许存储库访问 大型运行器”。

允许存储库访问 大型运行器

存储库被授权通过运行器组访问 大型运行器。 企业管理员可以选择向哪些组织授予对企业级运行器组的访问权限,组织所有者控制对所有 大型运行器 的存储库级访问权限。 组织所有者可以为其组织中的存储库使用和配置企业级运行器组,也可以创建组织级运行器组来控制访问。

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

一旦存储库有权访问 大型运行器,便可以将 大型运行器 添加到工作流文件。 有关详细信息,请参阅“在较大的运行器上运行作业”。

  1. 导航到运行器组所在的组织的主页。

  2. 单击 “设置”。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器组” 。

  4. 从页面上的任一列表中选择运行器组。 组织级运行器组列在页面顶部,而企业级运行器组列在“由企业共享”下。

  5. 在运行器组页的“存储库访问”下,选择“所有存储库”或“所选存储库”。 如果选择授予对特定存储库的访问权限,请单击 ,然后从列表中选择要向其授予访问权限的存储库。

警告

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

有关详细信息,请参阅“控制对较大运行器的访问”。

更改 大型运行器 的名称

  1. 在 GitHub.com 上,导航到组织的主页。

  2. 在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

  4. 在运行器列表中,选择要编辑的运行器。

  5. 在“名称”下的文本字段中输入运行器的新名称。

  6. 单击“ 保存”。

配置 大型运行器 自动缩放

可以控制允许针对特定运行器集并发运行的最大作业数。 将此字段设置为更高的值有助于防止工作流因并行而受阻。

  1. 在 GitHub.com 上,导航到组织的主页。

  2. 在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

  4. 在运行器列表中,选择要编辑的运行器。

  5. 在“自动缩放”部分的“最大作业并发”下,输入要允许同时运行的最大作业数。

  6. 单击“ 保存”。

为 大型运行器 创建静态 IP 地址

注意:若要使用静态 IP 地址,贵组织必须使用 GitHub Enterprise Cloud。 有关如何免费试用 GitHub Enterprise Cloud 的详细信息,请参阅“设置 GitHub Enterprise Cloud 的试用版”。

可以为 大型运行器 启用静态 IP 地址。 执行此操作时,会为 大型运行器 分配静态 IP 地址范围。 默认情况下,最多可为帐户配置 10 个具有 IP 范围的不同大型运行器。 如果要使用 10 个以上具有静态 IP 地址范围的大型运行器,请联系 GitHub 支持

分配范围中的可用 IP 地址数不会限制为自动缩放指定的并发作业数。 运行器池中有一个负载均衡器,允许高度重用分配范围内的 IP 地址。 这可确保在为每台计算机分配静态 IP 地址时,工作流可以大规模并发运行。

  1. 在 GitHub.com 上,导航到组织的主页。

  2. 在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在左侧边栏中,单击 “操作”,然后单击“运行器” 。

  4. 在运行器列表中,选择要编辑的运行器。

  5. 若要向运行器分配静态 IP 地址,请在“网络”下选中“为此运行器分配唯一的静态公共 IP 地址范围”。****

  6. 单击“保存” 。