跳到主要内容

工作流程

从 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 页面看日志、下载产物用量计量与计费