管理大型运行器

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

谁可以使用此功能？

大型运行器仅适用于使用 GitHub Team 或 GitHub Enterprise Cloud 计划的组织和企业。

企业或组织所有者可以管理大型运行器。

本文内容

注意

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

将大型运行器添加到组织

组织所有者可以将大型运行器添加到组织，并控制哪些存储库可以使用它。当您为组织创建新的运行器时，默认情况下，组织中的所有存储库都可以访问该运行器。要限制哪些存储库可以使用运行器，请将其分配到一个可以访问特定存储库的运行器组。有关更多信息，请参阅“允许存储库访问大型运行器”。

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

新的运行器会自动分配到默认组，或者您可以在运行器创建过程中选择运行器必须加入的组。此外，您可以在注册运行器后修改运行器的组成员身份。有关更多信息，请参阅“控制对大型运行器的访问”。

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

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在左侧边栏中，点击 **操作**，然后点击**运行器**。

  4. 点击**新建运行器**，然后点击** 新的 GitHub 托管运行器**。

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

    • **名称**：输入新运行器的名称。为了便于识别，这应该指示其硬件和操作系统配置，例如 ubuntu-20.04-16core。

    • **平台**：从可用选项中选择一个平台。选择平台后，您将能够选择特定的镜像。

    • **镜像**：从可用选项中选择一个镜像。选择镜像后，您将能够选择特定的尺寸。

      • GitHub 托管：对于由 GitHub 管理的镜像，请在此选项卡下选择一个镜像。
      • 合作伙伴：对于由合作伙伴管理的镜像，请在此选项卡下选择一个镜像。Windows 11 桌面版和针对 GPU 优化的镜像位于此选项卡下。

    • 大小：从可用选项列表中选择硬件配置。可用大小取决于您在先前步骤中选择的镜像。对于 GPU 运行器，请在GPU 加速选项卡下选择大小。

    • 最大并发数：选择任何时间可以处于活动状态的作业的最大数量。

    • 运行器组：选择您的运行器将所属的组。此组将托管运行器的多个实例，因为它们会根据需求进行扩展和缩减。

    注意

    大型运行器的名称可以决定其功能。例如，要将大型运行器用于代码扫描默认设置，则运行器的名称必须为code-scanning。有关使用大型运行器进行代码扫描的更多信息，请参阅“为默认设置配置大型运行器”。

  6. 点击创建运行器。

  7. 要允许存储库访问您的大型运行器，请将其添加到可以使用它的存储库列表中。有关更多信息，请参阅“允许存储库访问大型运行器”。

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

存储库通过运行器组获得对大型运行器的访问权限。企业管理员可以选择哪些组织可以访问企业级运行器组，而组织所有者则控制对所有大型运行器的存储库级访问权限。

组织所有者可以使用和配置其组织中的存储库的企业级运行器组，或者他们可以创建组织级运行器组来控制访问权限。

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

存储库获得对大型运行器的访问权限后，即可将大型运行器添加到工作流文件中。有关更多信息，请参阅“在大型运行器上运行作业”。

  1. 导航到位于运行器组所在的组织的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 Actions，然后点击运行器组。
  4. 从页面上的任一列表中选择一个运行器组。组织级运行器组列在页面顶部，企业级运行器组列在“企业共享”下。
  5. 在运行器组页面上的“存储库访问”下，选择所有存储库或选定的存储库。如果选择授予特定存储库访问权限，请点击，然后从列表中选择要授予访问权限的存储库。

警告

如果您使用的是固定 IP 范围，我们建议您仅将大型运行器与私有存储库一起使用。您的存储库的分支机构可以通过创建执行工作流中代码的拉取请求，在您的大型运行器上运行潜在的危险代码。有关更多信息，请参阅“控制对大型运行器的访问”。

更改大型运行器的名称

注意

大型运行器的名称可以决定其功能。例如，要将大型运行器用于代码扫描默认设置，则运行器的名称必须为code-scanning。有关使用大型运行器进行代码扫描的更多信息，请参阅“为默认设置配置大型运行器”。

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

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在左侧边栏中，点击 **操作**，然后点击**运行器**。

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

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

  6. 点击保存。

为大型运行器配置自动缩放

您可以控制允许为特定运行器集并发运行的作业的最大数量。将此字段设置为更高的值可以帮助防止由于并行性而导致工作流被阻塞。

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

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在左侧边栏中，点击 **操作**，然后点击**运行器**。

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

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

  6. 点击保存。

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

注意

要使用静态 IP 地址，您的组织必须使用 GitHub Enterprise Cloud。有关如何免费试用 GitHub Enterprise Cloud 的更多信息，请参阅“设置 GitHub Enterprise Cloud 的试用版”。

您可以为大型运行器启用静态 IP 地址。执行此操作时，大型运行器将被分配静态 IP 地址范围。分配范围内的所有 IP 地址均可用，并且不使用 CIDR 表示法。默认情况下，您可以为您的帐户配置最多 10 个具有 IP 范围的不同大型运行器。如果您想使用超过 10 个具有静态 IP 地址范围的大型运行器，请联系我们通过GitHub 支持门户。

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

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

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  3. 在左侧边栏中，点击 **操作**，然后点击**运行器**。

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

  5. 要将静态 IP 地址分配给运行器，请在“网络”下选中为该运行器分配唯一且静态的公共 IP 地址范围。

  6. 点击保存。