{"meta":{"title":"在工作流中使用自托管运行程序","intro":"要在工作流中使用自托管运行器，你可以使用标签或组来为作业指定运行器。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/how-tos","title":"操作方法"},{"href":"/zh/actions/how-tos/manage-runners","title":"管理运行器"},{"href":"/zh/actions/how-tos/manage-runners/self-hosted-runners","title":"自托管运行程序"},{"href":"/zh/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow","title":"在工作流中使用"}],"documentType":"article"},"body":"# 在工作流中使用自托管运行程序\n\n要在工作流中使用自托管运行器，你可以使用标签或组来为作业指定运行器。\n\n## 查看存储库可用的运行器\n\n如果对存储库具有 `repo: write` 访问权限，则可以查看存储库可用的运行器列表。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n2. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n \n3. 在左边栏中的“Management”部分下，单击 “Runners”\\*\\*\\*\\*。\n4. 单击运行器列表顶部的**自托管**选项卡。\n5. 查看存储库可用的自托管运行器列表。 此列表包括自托管运行器和使用 Actions Runner Controller 创建的运行器规模集。 有关详细信息，请参阅“[Actions Runner Controller](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller)”。\n6. （可选）要复制运行器标签以在工作流中使用，请单击运行器右侧的 ，然后单击“复制标签”。\\*\\*\\*\\*\n\n> \\[!NOTE]\n> 企业和组织所有者可以从此页面创建运行器。 若要创建新的运行器，请单击运行器列表右上角的“新建运行器”\\*\\*\\*\\*，将运行器添加到存储库。\n>\n> 有关详细信息，请参阅 [管理较大的运行器](/zh/actions/using-github-hosted-runners/managing-larger-runners) 和 [添加自托管的运行器](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners)。\n\n## 使用默认标签路由作业\n\n在被添加到 GitHub Actions 后，自托管运行器将自动收到某些标签。 这些被用于指出其操作系统和硬件平台：\n\n* `self-hosted`：应用于自托管运行器的默认标签。\n* `linux`、`windows` 或 `macOS`：根据操作系统应用。\n* `x64`、`ARM` 或 `ARM64`：根据硬件体系结构应用。\n\n您可以使用您工作流程的 YAML 将作业发送到这些标签的组合。 在此示例中，与所有三个标签匹配的自托管运行器将有资格运行该作业：\n\n```yaml\nruns-on: [self-hosted, linux, ARM64]\n```\n\n* `self-hosted` - 在自托管运行器上运行此作业。\n* `linux` - 仅使用基于 Linux 的运行器。\n* `ARM64` - 仅使用基于 ARM64 硬件的运行器。\n\n若要创建没有默认标签的单独自托管运行器，请在创建运行器时传递 `--no-default-labels` 标志。\n\n## 使用自定义标签路由作业\n\n你可以随时创建自定义标签并将其分配给你的自托管运行器。 自定义标签允许你根据其标注将作业发送给特定的自托管运行器类型。\n\n例如，如果某个作业需要特定类型的图形硬件，则可以创建名为 `gpu` 的自定义标签，并将其分配给安装了该硬件的运行器。 然后，与所有已分配的标签匹配的自托管运行器将有资格运行该作业。\n\n此示例显示组合默认标签和自定义标签的作业：\n\n```yaml\nruns-on: [self-hosted, linux, x64, gpu]\n```\n\n* `self-hosted` - 在自托管运行器上运行此作业。\n* `linux` - 仅使用基于 Linux 的运行器。\n* `x64` - 仅使用基于 x64 硬件的运行器。\n* `gpu` - 此自定义标签已被手动分配给安装了 GPU 硬件的自托管运行器。\n\n这些标签累计运行，所以自托管运行器必须拥有所有四个标签才能处理该作业。\n\n## 使用组来路由作业\n\n在此示例中，Ubuntu 运行器已添加到名为 `ubuntu-runners` 的组中。 `runs-on` 键将作业发送到 `ubuntu-runners` 组中的任何可用运行器：\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n check-bats-version:\n runs-on: \n group: ubuntu-runners\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-node@v4\n with:\n node-version: '14'\n - run: npm install -g bats\n - run: bats -v\n```\n\n## 使用标签和组来路由作业\n\n组合组和标签时，运行器必须满足这两项要求才能运行作业。\n\n在此示例中，名为 `ubuntu-runners` 的运行组配备了 Ubuntu 运行器，并且这些运行器被分配了标签 `ubuntu-24.04-16core`。\n`runs-on` 键将 `group` 和 `labels` 组合在一起，以便将作业路由到具有匹配标签的组内的任何可用运行器：\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n check-bats-version:\n runs-on:\n group: ubuntu-runners\n labels: ubuntu-24.04-16core\n steps:\n - uses: actions/checkout@v6\n - uses: actions/setup-node@v4\n with:\n node-version: '14'\n - run: npm install -g bats\n - run: bats -v\n```"}