Using labels with self-hosted runners

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."

A self-hosted runner can be located in either your repository, organization, or enterprise settings on your GitHub Enterprise Server instance. To manage a self-hosted runner, you must have the following permissions, depending on where the self-hosted runner was added:

• User repository: You must be the repository owner.

• Organization: You must be an organization owner.

• Organization repository: You must be an organization owner, or have admin access to the repository.

• Enterprise: You must be a GitHub Enterprise site administrator.

Creating a custom label

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

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

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

     1. 在 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.

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 的右上角，单击� 的个人资料照片，然后单击“企业设置”。

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 的右上角，单击� 的个人资料照片，然后单击“企业设置”。

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