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

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

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

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

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

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

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

创建自定义标签

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

   • 在组织或仓库中，导航到主页并单击 Settings（设置）。

   • 如果使用企业级运行器：

     1. 在任何页面的右上角，单击 。
     2. 在左边栏中，单击 Enterprise overview（企业概览）。
     3. 在企业边栏中，单击 Policies（政策）。

2. 导航到 GitHub Actions 设置：

   • 在组织或仓库中：点击左侧栏中的 Actions。
   • 如果使用企业级运行器：在“ Policies（政策）”下单击 Actions（操作）。

3. 在“自托管运行器” 下找到运行器列表。

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

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

6. 在“Filter labels（过滤标签）”字段中，键入新标签的名称，并单击 Create new label（创建新标签）。

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

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

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

   • 在组织或仓库中，导航到主页并单击 Settings（设置）。

   • 如果使用企业级运行器：

     1. 在任何页面的右上角，单击 。
     2. 在左边栏中，单击 Enterprise overview（企业概览）。
     3. 在企业边栏中，单击 Policies（政策）。

2. 导航到 GitHub Actions 设置：

   • 在组织或仓库中：点击左侧栏中的 Actions。
   • 如果使用企业级运行器：在“ Policies（政策）”下单击 Actions（操作）。

3. 在“自托管运行器” 下找到运行器列表。

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

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

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

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

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

   • 在组织或仓库中，导航到主页并单击 Settings（设置）。

   • 如果使用企业级运行器：

     1. 在任何页面的右上角，单击 。
     2. 在左边栏中，单击 Enterprise overview（企业概览）。
     3. 在企业边栏中，单击 Policies（政策）。

2. 导航到 GitHub Actions 设置：

   • 在组织或仓库中：点击左侧栏中的 Actions。
   • 如果使用企业级运行器：在“ Policies（政策）”下单击 Actions（操作）。

3. 在“自托管运行器” 下找到运行器列表。

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

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

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

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

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

./config.sh --labels gpu

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

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

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