跳至主要内容

工作流程

從 git push 到看到構建結果,中間發生了什麼?本頁介紹一條 CI 任務在 Macrunara 上的端到端流程。

總覽​

你的儲存庫(git push)
→ GitHub 排隊 + Webhook 通知 Macrunara
→ Macrunara 控制平面調度一台閒置 Mac mini M4
→ 秒級克隆一次性 VM,按需註冊 ephemeral Runner
→ GitHub 把 job 派給該 Runner 執行
→ 日誌即時回流到 Actions 頁面,job 結束後 Runner 註銷、VM 銷毀

單次 CI 任務端到端時序​

從 push 到收到結果,一條 CI 任務按以下五個階段流動,平台側動作(第 2–4 步)全程約 30–60 秒:

要點:一任務一 Runner 一 VM,任務結束全部回收,與 GitHub 官方對自託管 Runner 的安全指引(ephemeral + 自動化乾淨環境)完全一致。

結果、日誌與產物如何回傳​

  • 狀態與日誌:Runner 與 GitHub 之間是 Runner 主動發起的 HTTPS 長連線。排隊 / 進行中 / 成功失敗狀態與即時日誌直接呈現在你儲存庫的 Actions 頁面與 Checks API 上。
  • 編譯產物:產物不由 Macrunara 代管,而是按你 workflow 自身的步驟交付——actions/upload-artifact 存為 GitHub Artifacts、上傳 Release、或推送 TestFlight / App Store Connect。簽署證書與描述檔不進映像,由 CI 執行時注入臨時 keychain,任務結束隨 VM 銷毀。
  • 環境隔離:每個任務都從全新克隆的一次性 VM 啟動;job 結束後 Runner 註銷、VM 銷毀,任務之間零狀態殘留。

你設定什麼,平台做什麼​

你(在儲存庫中)Macrunara 平台(自動完成)
安裝 GitHub App、新增 MACRUNARA_INSTALLATION_ID secretWebhook 校驗、任務歸一化
workflow 中寫 runs-on: [macos, arm64, macrunara]JIT Token 簽發、節點調度、VM 克隆
定義建構 / 測試 / 上傳步驟ephemeral Runner 註冊與回收
在 Actions 頁面看日誌、下載產物用量計量與計費