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 的安全指引完全對齊