有关如何使用标签将作业路由到特定类型的自托管运行器的信息,请参阅“在工作流中使用自托管运行程序”。 还可以将作业路由到特定组中的运行器。 有关详细信息,请参阅“选择作业的运行器”。
自托管运行器可位于存储库、组织或 GitHub 上的企业帐户设置中。 要管理自托管运行器,您必须拥有以下权限,具体取决于添加自托管运行器的位置:
-
用户存储库:你必须是存储库所有者。
-
组织:你必须是组织所有者。
-
组织存储库:你必须是组织所有者,或者拥有对存储库的管理员访问权限。
-
企业帐户:你必须是企业所有者。
创建自定义标签
-
导航到运行器注册的位置:
-
在组织或存储库中:导航到主页并单击“ 设置” 。
-
如果使用的是企业级运行器:
-
在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。
-
在企业列表中,单击您想要查看的企业。
-
-
-
导航到 GitHub Actions 设置:
-
在组织或存储库中:
- 在左侧边栏中,单击“操作”,然后单击“运行器”。
-
如果使用的是企业级运行器:
- 在企业帐户边栏中,单击“ 策略”。 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。
-
-
在“Labels(标签)”部分,单击 。
-
在“查找或创建标签”字段中,键入新标签的名称,然后单击“创建新标签”。 将创建自定义标签并分配给自托管运行器。 可以从自托管的运行器中删除自定义标签,但当前无法手动删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。
分配标签给自托管的运行器
-
导航到运行器注册的位置:
-
在组织或存储库中:导航到主页并单击“ 设置” 。
-
如果使用的是企业级运行器:
-
在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。
-
在企业列表中,单击您想要查看的企业。
-
-
-
导航到 GitHub Actions 设置:
-
在组织或存储库中:
- 在左侧边栏中,单击“操作”,然后单击“运行器”。
-
如果使用的是企业级运行器:
- 在企业帐户边栏中,单击“ 策略”。 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。 1. 在“Labels(标签)”部分,单击 。
-
-
要将标签分配给您的自托管运行器,在“Find or create a label(查找或创建标签)”字段中单击标签。
删除自托管运行器中的自定义标签
-
导航到运行器注册的位置:
-
在组织或存储库中:导航到主页并单击“ 设置” 。
-
如果使用的是企业级运行器:
-
在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的企业”。
-
在企业列表中,单击您想要查看的企业。
-
-
-
导航到 GitHub Actions 设置:
-
在组织或存储库中:
- 在左侧边栏中,单击“操作”,然后单击“运行器”。
-
如果使用的是企业级运行器:
- 在企业帐户边栏中,单击“ 策略”。 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。 1. 在“Labels(标签)”部分,单击 。
-
-
在“查找或创建标签”字段中,分配的标签标有 图标。 单击标记的标签以将其从您的自托管运行器取消分配。
以编程方式分配标签
可以在创建运行器后或其初始配置期间以编程方式将标签分配给自承载运行器。
-
若要以编程方式将标签分配给现有自承载运行器,必须使用 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
注: 如果替换现有的运行器,则必须重新分配任何自定义标签。