有关如何使用标签将作业路由到特定类型的自托管运行器的信息，请参阅“在工作流中使用自托管运行器”。您还可以将作业路由到特定组中的运行器。有关更多信息，请参阅“选择作业的运行器”。
自托管运行器可以位于 GitHub 上的存储库、组织或企业帐户设置中。要管理自托管运行器，您必须具有以下权限，具体取决于自托管运行器的添加位置
- 用户存储库：您必须是存储库所有者。
- 组织：您必须是组织所有者。
- 组织存储库：您必须是组织所有者，或对存储库具有管理员访问权限。
注意
Actions Runner Controller 不支持多个标签，如需了解更多信息，请阅读我们的 Actions Runner Controller 文档
创建自定义标签
您可以在存储库和组织级别为运行器创建自定义标签。
注意
标签不区分大小写。
为存储库运行器创建自定义标签
- 导航到已注册自托管运行器组的存储库的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在运行器列表中，点击要配置的运行器的名称。
- 在“标签”部分，点击.
- 在“查找或创建标签”字段中，输入新标签的名称，然后点击创建新标签。自定义标签已创建并分配给自托管运行器。可以从自托管运行器中删除自定义标签，但目前无法手动删除它们。任何未分配给运行器的未使用标签将在 24 小时内自动删除。
为组织运行器创建自定义标签
- 导航到已注册自托管运行器组的组织的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在运行器列表中，点击要配置的运行器的名称。
- 在“标签”部分，点击.
- 在“查找或创建标签”字段中，输入新标签的名称，然后点击创建新标签。自定义标签已创建并分配给自托管运行器。可以从自托管运行器中删除自定义标签，但目前无法手动删除它们。任何未分配给运行器的未使用标签将在 24 小时内自动删除。
将标签分配给自托管运行器
您可以在存储库和组织级别将标签分配给自托管运行器。
将标签分配给存储库运行器
- 导航到已注册自托管运行器组的存储库的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在“标签”部分，点击.
- 要将标签分配给您的自托管运行器，请在“查找或创建标签”字段中，点击该标签。
将标签分配给组织运行器
- 导航到已注册自托管运行器组的组织的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在“标签”部分，点击.
- 要将标签分配给您的自托管运行器，请在“查找或创建标签”字段中，点击该标签。
从自托管运行器中删除自定义标签
您可以在存储库和组织级别从自托管运行器中删除自定义标签。
从存储库运行器中删除自定义标签
- 导航到已注册自托管运行器组的存储库的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在“标签”部分，点击.
- 在“查找或创建标签”字段中，已分配的标签将用图标标记。点击标记的标签以将其从自托管运行器中取消分配。
从组织运行器中删除自定义标签
- 导航到已注册自托管运行器组的组织的主页面。
- 点击 设置.
- 在左侧边栏中，点击 Actions，然后点击Runners。
- 在“标签”部分，点击.
- 在“查找或创建标签”字段中，已分配的标签将用图标标记。点击标记的标签以将其从自托管运行器中取消分配。
以编程方式分配标签
您可以在运行器创建后或在初始配置期间以编程方式将标签分配给自托管运行器。
-
要以编程方式将标签分配给现有的自托管运行器，您必须使用 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注意
如果替换现有运行器，则必须重新分配任何自定义标签。