使用自托管运行器的标签

您可以使用标签根据自托管运行器的特性对其进行组织。

本文内容

有关如何使用标签将作业路由到特定类型的自托管运行器的信息，请参阅“在工作流中使用自托管运行器”。您还可以将作业路由到特定组中的运行器。有关更多信息，请参阅“选择作业的运行器”。

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

  • **用户存储库**：您必须是存储库所有者。
  • **组织**：您必须是组织所有者。
  • **组织存储库**：您必须是组织所有者，或对存储库具有管理员访问权限。

注意

Actions 运行器控制器不支持多个标签，如需了解更多信息，请阅读我们的 Actions 运行器控制器文档

创建自定义标签

您可以在存储库和组织级别为运行器创建自定义标签。

注意

标签不区分大小写。

为存储库运行器创建自定义标签

  1. 导航到注册自托管运行器组的存储库的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在运行器列表中，点击您想要配置的运行器的名称。
  5. 在“标签”部分，点击.
  6. 在“查找或创建标签”字段中，输入新标签的名称，然后点击创建新标签。自定义标签已创建并分配给自托管运行器。可以从自托管运行器中删除自定义标签，但目前无法手动删除它们。任何未分配给运行器的未使用标签将在 24 小时内自动删除。

为组织运行器创建自定义标签

  1. 导航到注册自托管运行器组的组织的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在运行器列表中，点击您想要配置的运行器的名称。
  5. 在“标签”部分，点击.
  6. 在“查找或创建标签”字段中，输入新标签的名称，然后点击创建新标签。自定义标签已创建并分配给自托管运行器。可以从自托管运行器中删除自定义标签，但目前无法手动删除它们。任何未分配给运行器的未使用标签将在 24 小时内自动删除。

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

您可以将标签分配到存储库和组织级别的自托管运行器。

将标签分配给存储库运行器

  1. 导航到注册自托管运行器组的存储库的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在“标签”部分，点击.
  5. 要将标签分配给您的自托管运行器，请在“查找或创建标签”字段中，点击该标签。

将标签分配给组织运行器

  1. 导航到注册自托管运行器组的组织的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在“标签”部分，点击.
  5. 要将标签分配给您的自托管运行器，请在“查找或创建标签”字段中，点击该标签。

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

您可以从存储库和组织级别的自托管运行器中删除自定义标签。

从存储库运行器中删除自定义标签

  1. 导航到注册自托管运行器组的存储库的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在“标签”部分，点击.
  5. 在“查找或创建标签”字段中，分配的标签用图标标记。点击标记的标签以将其从自托管运行器中取消分配。

从组织运行器中删除自定义标签

  1. 导航到注册自托管运行器组的组织的主页。
  2. 点击 设置.
  3. 在左侧边栏中，点击 操作，然后点击运行器。
  4. 在“标签”部分，点击.
  5. 在“查找或创建标签”字段中，分配的标签用图标标记。点击标记的标签以将其从自托管运行器中取消分配。

以编程方式分配标签

您可以在创建自托管运行器后或在其初始配置期间以编程方式将标签分配给它。

  • 要以编程方式将标签分配给现有的自托管运行器，您必须使用 REST API。有关更多信息，请参阅“自托管运行器的 REST API 端点”。

  • 要在自托管运行器的初始运行器配置期间以编程方式分配标签，您可以使用labels参数将标签名称传递给config脚本。

    注意

    您不能使用config脚本将标签分配给现有的自托管运行器。

    例如，此命令在配置新的自托管运行器时分配名为gpu的标签

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu

    如果标签不存在，则会创建它。您还可以使用此方法将默认标签分配给运行器，例如x64或linux。当使用配置脚本分配默认标签时，GitHub Actions 会将其视为已知，并且不会验证运行器是否确实使用了该操作系统或架构。

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

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux

    注意

    如果替换现有的运行器，则必须重新分配所有自定义标签。