跳到主要内容

构建流水线

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 节点前,会执行多重过滤规则,筛选出符合要求的执行节点。

  1. 标签匹配过滤:任务 runs-on 标签集合必须是节点上报标签的子集,只有标签完全匹配的 M4 机器才可以承接该任务。
  2. 租户与套餐过滤:根据客户套餐等级,匹配对应资源规格的节点,不同套餐可使用的节点资源存在差异。
  3. 区域机房过滤:支持按区域指定机房;不指定时平台自动根据负载、距离自动择优分配机房。
  4. 配额与负载过滤:校验客户余额、并发上限、节点负载,当配额用尽或无空闲节点时任务会进入排队等待。
┌──────────────┐         ┌──────────────┐             ┌────────────┐
│ 收到 CI 任务 │ ──────→ │ 标签匹配校验 │ ──不匹配──→ │ 排除该节点 │
└──────────────┘ └──────────────┘ └────────────┘
│ 匹配
▼
┌───────────────┐ ┌──────────────┐
│ 套餐/配额校验 │ ──不通过──→ │ 任务进入排队 │
└───────────────┘ └──────────────┘
│ 通过
▼
┌───────────────┐ ┌────────────────────┐
│ 机房/负载筛选 │ ───→ │ 下发任务至 M4 节点 │
└───────────────┘ └────────────────────┘

产物传递​

Workflow 可以通过 artifacts 保存构建产出,跨 job 传递归档包、编译产物,用于后续签名、导出、TestFlight 上传;任务结束后执行环境销毁。

┌─────────────────┐                  ┌──────────┐       ┌─────────────────┐
│ 构建 job │ artifacts 传递 │ 签名 job │ ───→ │ 上传 TestFlight │
│ 输出 .xcarchive │ ───────────────→ │ 导出 APP │ └─────────────────┘
└─────────────────┘ └──────────┘