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

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

注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

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

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

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

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

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

  • 企业:您必须是 GitHub Enterprise 站点管理员。

创建自定义标签

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

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业级运行器
      1. 在任何页面的右上角,单击
      2. 在左边栏中,单击 Enterprise overview(企业概览)
      3. In the enterprise sidebar, click Policies.
  2. 导航到 GitHub Actions 设置:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise-level runner: Click Actions under " Policies", then click the Runners tab.
  3. 在“运行器” 下找到运行器列表。

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

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

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

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

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

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

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业级运行器
      1. 在任何页面的右上角,单击
      2. 在左边栏中,单击 Enterprise overview(企业概览)
      3. In the enterprise sidebar, click Policies.
  2. 导航到 GitHub Actions 设置:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise-level runner: Click Actions under " Policies", then click the Runners tab.
  3. 在“运行器” 下找到运行器列表。

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

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

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

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

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

    • 在组织或仓库中,导航到主页并单击 Settings(设置)
    • 如果使用企业级运行器
      1. 在任何页面的右上角,单击
      2. 在左边栏中,单击 Enterprise overview(企业概览)
      3. In the enterprise sidebar, click Policies.
  2. 导航到 GitHub Actions 设置:

    • In an organization or repository: Click Actions in the left sidebar, then click Runners.
    • If using an enterprise-level runner: Click Actions under " Policies", then click the Runners tab.
  3. 在“运行器” 下找到运行器列表。

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

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

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

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

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

./config.sh --labels gpu

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

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

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

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

此文档对您有帮助吗?

隐私政策

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

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

做出贡献

或者, 了解如何参与。