跳到主要内容

Runner

在 Macrunara 上,一条构建任务的生命周期可以分成三步看懂:任务跑在什么样的机器上(硬件设备)→ 任务怎么被分配到这些机器(runs-on 标签)→ 分配之后平台做了什么(JIT + Ephemeral 注册)。本页按这个顺序说明。

硬件设备​

你的每个构建任务,最终都运行在这样的节点上——每个 Macrunara 节点都是一台 Mac mini M4,基于 Apple Silicon:

  • 机型:Mac mini(Mac16,10)
  • 芯片:Apple M4,10 核 CPU(4 性能核 + 6 能效核)
  • 内存:16GB 统一内存

用 runs-on 选择 Runner​

知道了任务跑在什么机器上,下一步是告诉 GitHub:把我的任务派给这些机器。这通过 workflow 里的 runs-on 标签完成,使用标准三标签写法:

jobs:
build:
runs-on: [macos, arm64, macrunara]

runs-on 采用 AND 匹配:你写的每个标签都必须是节点上报的标签,你的标签列表必须是节点标签的子集。

更多写法示例与排队排查,参考 runs-on 标签约定与排查 FAQ。

标签写错会永远排队

写 self-hosted 或 macos-latest 会导致任务永远排队且无报错,因为 Macrunara 节点不上报这些标签。

标签在注册时固定

Runner 标签在向 GitHub 注册时即固定,job 内无法修改——setup action 和任何 workflow 步骤都无法更改。每个任务的标签由 Macrunara 控制面自动生成(平台 / 组织 / 套餐 / 机房四个维度),组织隔离由平台保证,你只需要写标准三标签即可。

JIT + Ephemeral 注册模式​

标签匹配命中后,平台不会让你的任务等待一台"常驻 Runner"——而是为这次任务现场注册一个一次性 Runner,用完即毁。这就是 JIT(just-in-time)+ ephemeral 模式,一次任务的完整生命周期:

步骤发生什么典型耗时
1. 任务排队GitHub 向 Macrunara 控制面推送 workflow_job webhook< 1 秒
2. 签发 Token控制面以 GitHub App 身份为你的安装生成一次性 JIT Token(约 60 分钟有效)1–2 秒
3. 克隆环境Token 下发到一台空闲 M4 节点,节点从本机已预热的镜像克隆一个全新 VM(APFS 写时复制)25–30 秒
4. 注册领取VM 内的 Runner 以 ephemeral 模式向 GitHub 注册并领取任务5–10 秒
5. 自动回收任务结束后 Runner 自动注销,VM 销毁,工作目录清空< 30 秒

关键特性​

  • 一任务一 Runner:每个任务获得独立的一次性 Runner——没有 Runner 空闲驻留占用你的 GitHub Runner 配额
  • 每任务干净环境:不沿用上一个任务的任何残留
  • 无需人工处理 Token:注册 Token 从不经人工复制,全部通过 App 的 JIT 机制按任务下发,与 GitHub 对自托管 Runner 的安全指引完全对齐

最佳实践​

  1. 始终写 runs-on: [macos, arm64, macrunara]——不要用 self-hosted 或 macos-latest
  2. 让任务自包含——每个任务都运行在全新的一次性 VM 中,依赖请通过 workflow 步骤恢复