在工作流程中使用自托管的运行器

有关创建自定义和默认标签的信息，请参阅“将标签与自托管运行器一起使用。”

在工作流程中使用自托管的运行器

标签允许您根据其共同特征向特定类型的自托管运行器发送工作流程作业。 例如，如果您的作业需要特定的硬件组件或软件包。 您可以将一个自定义标签分配给运行器，然后将您的作业配置为仅在带该标签的运行器中执行。

要为工作指定自托管的运行器，请在工作流程文件中使用自托管运行器标签配置 runs-on。

所有自托管的运行器都有 self-hosted 标签，您可以只提供 self-hosted 标签来选择任何自托管运行器。 您也可以在一个带附加标签（例如用于特定操作系统或系统架构的标签）的数组中使用 self-hosted，只选择您指定的运行器类型。

更多信息请参阅“GitHub Actions 的工作流程语法”。

使用默认标签路由作业

在被添加到 GitHub Actions 后，自托管运行器将自动收到某些标签。 这些被用于指出其操作系统和硬件平台：

• self-hosted：应用到所有自托管运行器的默认标签。
• linux、windows 或 macOS：根据操作系统应用。
• x86、x64、ARM 或 ARM64：根据硬件架构应用。

您可以使用您工作流程的 YAML 将作业发送到这些标签的组合。 在此示例中，与所有三个标签匹配的自托管运行器将有资格运行该作业：

runs-on: [self-hosted, linux, ARM64]

• self-hosted - 在自托管运行器上运行此作业。
• linux - 仅使用基于 Linux 的运行器。
• ARM64 - 仅使用基于 ARM64 硬件的运行器。

默认标签是固定的，无法更改或删除。 如果您需要对作业路由的更多控制，考虑使用自定义标签。

使用自定义标签路由作业

您可以随时创建自定义标签并将其分配给您的自托管运行器。 自定义标签允许您根据其标注将作业发送给特定的自托管运行器类型。

例如，如果您的某个作业需要特定类型的图形硬件，则可以创建名为 gpu 的自定义标签，并将其分配给安装了该硬件的运行器。 然后，与所有已分配的标签匹配的自托管运行器将有资格运行该作业。

此示例显示组合默认标签和自定义标签的作业：

runs-on: [self-hosted, linux, x64, gpu]

• self-hosted - 在自托管运行器上运行此作业。
• linux - 仅使用基于 Linux 的运行器。
• x64 - 仅使用基于 x64 硬件的运行器。
• gpu - 此自定义标签已被手动分配给安装了 GPU 硬件的自托管运行器。

这些标签累计运行，所以自托管运行器的标签必须匹配所有四个标签才能处理该作业。

自托管运行器的路由优先级

如果同时使用仓库级和组织级的运行器，GitHub 在将作业传送给自托管运行器时遵循优先顺序：

1. 作业的 runs-on 标签经过处理。 GitHub 然后会尝试查找符合标签要求的运行器：
2. 作业将发送到与作业标签匹配的仓库级运行器。 如果没有仓库级运行程序可用（忙、脱机或没有匹配的标签）：
3. 作业将发送到与作业标签匹配的组织级运行器。 如果没有组织级运行器可用，作业请求将失败并出错。