构建流水线
Macrunara 提供 M4 构建节点,执行 GitHub Actions 定义的 CI/CD workflow。GitHub Actions 原生支持多阶段编排,覆盖从代码检出、依赖拉取、编译构建、自动化测试到签名打包、产物分发全流程。
流水线结构
GitHub Actions workflow 由多个 job 按顺序串联执行。每个 job 内部包含一组执行步骤,依次完成准备、编译、测试、发布等;上一 job 执行完成才进入下一 job,任意 job 失败,流水线终止。
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
│ 准备 job │ ───→ │ 构建 job │ ───→ │ 测试 job │ ───→ │ 发布 job │
└────────────┘ └────────────┘ └────────────┘ └────────────┘
并行阶段
互相之间无依赖的 job 可以配置为并行执行,多个 job 同时在 Macrunara M4 节点上运行,缩短整体耗时,适合同时编译 iOS、macOS、visionOS 多平台产物。
┌──→ iOS 编译 job ──┐
构建触发 ────┼──→ macOS 编译 job ──┼──→ 全部任务结束
└──→ visionOS 编译 job ──┘
任务调度过滤
Macrunara 调度层在分配 CI 任务到 M4 节点前,会执行多重过滤规则,筛选出符合要求的执行节点。
- 标签匹配过滤:任务
runs-on标签集合必须是节点上报标签的子集,只有标签完全匹配的 M4 机器才可以承接该任务。 - 租户与套餐过滤:根据客户套餐等级,匹配对应资源规格的节点,不同套餐可使用的节点资源存在差异。
- 区域机房过滤:支持按区域指定机房;不指定时平台自动根据负载、距离自动择优分配机房。
- 配额与负载过滤:校验客户余额、并发上限、节点负载,当配额用尽或无空闲节点时任务会进入排队等待。
┌──────────────┐ ┌──────────────┐ ┌────────────┐
│ 收到 CI 任务 │ ──────→ │ 标签匹配校验 │ ──不匹配──→ │ 排除该节点 │
└──────────────┘ └──────────────┘ └────────────┘
│ 匹配
▼
┌───────────────┐ ┌──────────────┐
│ 套餐/配额校验 │ ──不通过──→ │ 任务进入排队 │
└───────────────┘ └──────────────┘
│ 通过
▼
┌───────────────┐ ┌────────────────────┐
│ 机房/负载筛选 │ ───→ │ 下发任务至 M4 节点 │
└───────────────┘ └────────────────────┘
产物传递
Workflow 可以通过 artifacts 保存构建产出,跨 job 传递归档包、编译产物,用于后续签名、导出、TestFlight 上传;任务结束后执行环境销毁。
┌─────────────────┐ ┌──────────┐ ┌─────────────────┐
│ 构建 job │ artifacts 传递 │ 签名 job │ ───→ │ 上传 TestFlight │
│ 输出 .xcarchive │ ───────────────→ │ 导出 APP │ └─────────────────┘
└─────────────────┘ └──────────┘