CI/CD / 系统课时

用标签把任务路由到指定机器

用标签把任务路由到指定机器

当团队同时拥有普通构建机、GPU 节点和生产部署机时,仅写 self-hosted 会让任务的可执行范围过大。Runner labels 可以描述节点能力,让 GitHub Actions 只把 Job 分配给同时满足指定标签的 Runner。

学习目标

  • 理解 Runner 标签与 runs-on 的匹配关系
  • 为不同能力的机器设计可读、稳定的自定义标签
  • 验证 Job 是否真正进入预期执行节点

标签解决什么问题

自托管 Runner 注册后通常带有 self-hosted,并具有操作系统、架构等默认标签。你还可以添加 gpu、build、production 等自定义标签,用来表达这台机器承担的职责或拥有的能力。

当 runs-on 使用标签数组时,目标 Runner 必须同时匹配其中的全部标签。例如一个 Job 要求 self-hosted、linux 和 production,只有同时具备这三个标签且可接收任务的 Runner 才符合路由条件。

Runner 标签交集路由任务

给 Runner 添加职责标签

对于已经注册的 Runner,可以在仓库的 Settings → Actions → Runners 中打开对应节点并管理自定义标签。标签应描述相对稳定的能力,而不是临时任务名称。例如 gpu 表示硬件能力,production 表示部署边界,build 表示构建职责。

如果在首次注册时就知道节点职责,也可以通过 config.sh 的 --labels 参数加入自定义标签。下面是重新注册或首次注册时的片段示例,依赖 Runner 已下载解压,并且 <TOKEN> 是当前有效的注册令牌。

bash
./config.sh \
  --url https://github.com/<OWNER>/<REPO> \
  --token <TOKEN> \
  --name <RUNNER_NAME> \
  --labels build,production

预期输出

text
√ Runner successfully added
√ Settings Saved.

注册完成后,应在该 Runner 的标签列表中看到 build 和 production。具体默认标签还取决于节点的操作系统和架构。

在工作流中组合标签

假设生产部署只能在 Linux 生产节点执行,可以把多个条件同时写入 runs-on。这是完整的手动触发工作流示例。

yaml
name: production-runner-check

on:
  workflow_dispatch:

jobs:
  check-host:
    runs-on: [self-hosted, linux, production]
    steps:
      - name: Verify execution host
        run: |
          echo "runner=$RUNNER_NAME"
          uname -s

预期输出

text
runner=<RUNNER_NAME>
Linux

<RUNNER_NAME> 是实际接收任务的 Runner 名称。工作流不会因为某台机器只拥有其中两个标签就降低条件;没有同时满足全部标签的可用 Runner 时,Job 会继续排队等待匹配节点。

验证路由是否正确

验证标签路由时,不要只看 Job 最终是否成功,还要确认执行节点身份。工作流日志会显示被分配的 Runner 信息,也可以像上例一样输出 RUNNER_NAME,将实际节点与预期标签设计进行核对。

如果 Job 长时间显示等待 Runner,依次检查 runs-on 中是否存在拼写错误、目标 Runner 是否在线、所需标签是否全部存在,以及符合条件的节点是否正被其他 Job 占用。尤其不要通过删除 production 之类的边界标签来临时消除排队,否则任务可能被路由到不应执行部署的机器。

标签路由的关键不是给机器贴得越多越好,而是让工作流明确表达执行约束:通用构建使用通用节点,需要特殊硬件或生产权限的任务再增加对应标签,从路由层面缩小可执行范围。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用标签把任务路由到指定机器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通