Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

Using labels with self-hosted runners

You can use labels to organize your self-hosted runners based on their characteristics.

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

For information on how to use labels to route jobs to specific types of self-hosted runners, see "Using self-hosted runners in a workflow."

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

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

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

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

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

Creating a custom label

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

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

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

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

    • 在组织或存储库中:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。
  3. 在“运行程序”下找到运行程序列表。

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

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

  6. In the "Filter labels" field, type the name of your new label, and click Create new label. Add runner label

The custom label is created and assigned to the self-hosted runner. Custom labels can be removed from self-hosted runners, but they currently can't be manually deleted. 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。

Assigning a label to a self-hosted runner

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

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

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

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

    • 在组织或存储库中:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。
  3. 在“运行程序”下找到运行程序列表。

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

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

  6. Click on a label to assign it to your self-hosted runner.

Removing a custom label from a self-hosted runner

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

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

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

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

    • 在组织或存储库中:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • 如果使用的是企业级运行器:

      1. 在企业边栏中,单击 “策略”。 企业帐户边栏中的“策略”选项卡 1. 在“ 策略”下,单击“操作”。 1. 单击“运行器”选项卡。
  3. 在“运行程序”下找到运行程序列表。

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

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

  6. Click on the assigned label to remove it from your self-hosted runner. 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。

Using the configuration script to create and assign labels

You can use the configuration script on the self-hosted runner to create and assign custom labels. For example, this command assigns a label named gpu to the self-hosted runner.

./config.sh --labels gpu

The label is created if it does not already exist. You can also use this approach to assign the default labels to runners, such as x64 or linux. When default labels are assigned using the configuration script, GitHub Actions accepts them as given and does not validate that the runner is actually using that operating system or architecture.

You can use comma separation to assign multiple labels. For example:

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

Note: If you replace an existing runner, then you must reassign any custom labels.