我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

将标签与自托管运行器一起使用

您可以使用标签以基于其特性来组织自托管运行器。

本文内容

有关如何使用标签将作业路由到特定类型的自托管运行器的信息,请参阅“在工作流程中使用自托管的运行器”。

自托管运行器可位于仓库、组织或GitHub 上的企业帐户设置中。 要管理自托管运行器,您必须拥有以下权限,具体取决于添加自托管运行器的位置:

  • 用户仓库:您必须是仓库所有者。

  • 组织:您必须是组织所有者。

  • 组织仓库:您必须是组织所有者或者拥有该仓库的管理员权限。

  • 企业账户:您必须是企业所有者。

创建自定义标签

  1. 导航到自托管运行器注册的位置:

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业帐户:通过访问 https://github.com/enterprises/ENTERPRISE-NAME(将 ENTERPRISE-NAME 替换为您的企业帐户名称)导航到您的企业帐户。 在企业边栏中,单击 Policies(政策)
  2. 导航到 GitHub Actions 设置:

    • 在组织或仓库中:单击左边栏中的 Actions(操作)

      操作设置

    • 如果使用企业帐户:在“ Policies(政策)”下单击 Actions(操作)

  3. 在“Self-hosted runners(自托管运行器)”下找到运行器列表。

  4. 如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。

    列出运行器组

  5. 找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有

    更改运行器标签

  6. 在“Filter labels(过滤标签)”字段中,键入新标签的名称,并单击 Create new label(创建新标签)

    添加运行器标签

将创建自定义标签并分配给自托管运行器。 可以从自托管的运行器中删除自定义标签,但当前无法手动删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。

分配标签给自托管的运行器

  1. 导航到自托管运行器注册的位置:

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业帐户:通过访问 https://github.com/enterprises/ENTERPRISE-NAME(将 ENTERPRISE-NAME 替换为您的企业帐户名称)导航到您的企业帐户。 在企业边栏中,单击 Policies(政策)
  2. 导航到 GitHub Actions 设置:

    • 在组织或仓库中:单击左边栏中的 Actions(操作)

      操作设置

    • 如果使用企业帐户:在“ Policies(政策)”下单击 Actions(操作)

  3. 在“Self-hosted runners(自托管运行器)”下找到运行器列表。

  4. 如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。

    列出运行器组

  5. 找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有

    更改运行器标签

  6. 单击标签以将其分配给您的自托管运行器。

删除自托管运行器中的自定义标签

  1. 导航到自托管运行器注册的位置:

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业帐户:通过访问 https://github.com/enterprises/ENTERPRISE-NAME(将 ENTERPRISE-NAME 替换为您的企业帐户名称)导航到您的企业帐户。 在企业边栏中,单击 Policies(政策)
  2. 导航到 GitHub Actions 设置:

    • 在组织或仓库中:单击左边栏中的 Actions(操作)

      操作设置

    • 如果使用企业帐户:在“ Policies(政策)”下单击 Actions(操作)

  3. 在“Self-hosted runners(自托管运行器)”下找到运行器列表。

  4. 如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。

    列出运行器组

  5. 找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有

    更改运行器标签

  6. 单击分配的标签以将其从您的自托管运行器中删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。

使用配置脚本创建和分配标签

您可以使用自托管运行器上的配置脚本创建和分配自定义标签。 例如,此命令将名为 gpu 的标签分配给自托管运行器。

./config.sh --labels gpu

如果标签不存在,则创建该标签。 您也可以使用此方法将默认标签分配给运行器,例如 x64linux.。 使用配置脚本分配默认标签后, GitHub Actions 会接受它们,而不验证运行器是否实际使用该操作系统或架构。

您可以使用逗号分隔来分配多个标签。 例如:

./config.sh --labels gpu,x64,linux

注: 如果替换现有的运行器,则必须重新分配任何自定义标签。

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。