Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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

您可以使用标签以基于其特性来组织自托管运行器。

注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

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

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

  • 用户存储库:你必须是存储库所有者。

  • 组织:你必须是组织所有者。

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

  • 企业:你必须是 GitHub Enterprise 站点管理员。

创建自定义标签

  1. 导航到运行器注册的位置:

    • 在组织或存储库中:导航到主页并单击“ 设置” 。

    • 如果使用的是企业级运行器:

      1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置”
  2. 导航到 GitHub Actions 设置:

    • 在组织或存储库中:

      1. 在左侧边栏中,单击“操作”,然后单击“运行器”。
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。
  3. 在“Labels(标签)”部分,单击

  4. 在“查找或创建标签”字段中,键入新标签的名称,然后单击“创建新标签”。 将创建自定义标签并分配给自托管运行器。 可以从自托管的运行器中删除自定义标签,但当前无法手动删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。

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

  1. 导航到运行器注册的位置:

    • 在组织或存储库中:导航到主页并单击“ 设置” 。

    • 如果使用的是企业级运行器:

      1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置”
  2. 导航到 GitHub Actions 设置:

    • 在组织或存储库中:

      1. 在左侧边栏中,单击“操作”,然后单击“运行器”。
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。 1. 在“Labels(标签)”部分,单击
  3. 要将标签分配给您的自托管运行器,在“Find or create a label(查找或创建标签)”字段中单击标签。

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

  1. 导航到运行器注册的位置:

    • 在组织或存储库中:导航到主页并单击“ 设置” 。

    • 如果使用的是企业级运行器:

      1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置”
  2. 导航到 GitHub Actions 设置:

    • 在组织或存储库中:

      1. 在左侧边栏中,单击“操作”,然后单击“运行器”。
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。 1. 在运行器列表中,单击要配置的运行器的名称。 1. 在“Labels(标签)”部分,单击
  3. 在“查找或创建标签”字段中,分配的标签标有 图标。 单击标记的标签以将其从您的自托管运行器取消分配。

以编程方式分配标签

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

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

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

    注意:不能使用 config 脚本将标签分配给现有自承载运行器。

    例如,此命令在配置新的自承载运行器时分配名为 gpu 的标签:

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

    如果标签不存在,则创建该标签。 还可使用此方法为运行器(例如 x64linux)分配默认标签。 使用配置脚本分配默认标签后, GitHub Actions 会接受它们,而不验证运行器是否实际使用该操作系统或架构。

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

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

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