跳至主要内容

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 步驟恢復