将标签与自托管运行程序结合使用

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

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

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

创建自定义标签

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

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

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

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

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

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

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

可以在存储库以及组织级别为自托管运行器分配标签。

• 为存储库运行器分配标签
• 为组织运行器分配标签

为存储库运行器分配标签

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

为组织运行器分配标签

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

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

可以在存储库以及组织级别从自托管运行器中移除自定义标签。

• 从存储库运行器中删除自定义标签
• 从组织运行器中移除自定义标签

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

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

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

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

以编程方式分配标签

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

• 若要以编程方式将标签分配给现有自承载运行器，必须使用 REST API。 有关详细信息，请参阅“自托管运行器的 REST API 终结点”。

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

  Note

  不能使用 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
  

  Note

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