并发与矩阵构建
利用 GitHub Actions 矩阵和一次性 ephemeral Runner,让多种配置并行构建,加速你的 CI。
矩阵构建
使用 GitHub Actions matrix 并行构建多种配置——例如 Release/Debug 或 iOS/macOS。每个矩阵组合都会成为一个独立的 job:
name: Matrix CI
on:
push:
branches: [main]
jobs:
build:
runs-on: [macos, arm64, macrunara]
strategy:
matrix:
configuration: [Release, Debug]
sdk: [iphoneos, macosx]
steps:
- uses: actions/checkout@v4
- uses: macrunara/setup-action@v1
with:
installation-id: ${{ secrets.MACRUNARA_INSTALLATION_ID }}
region: auto
- uses: macrunara/local-mac-runner-action@v1
with:
scheme: MyApp
configuration: ${{ matrix.configuration }}
sdk: ${{ matrix.sdk }}
upload_artifact: true
artifact_name: build-${{ matrix.configuration }}-${{ matrix.sdk }}
artifact_path: build/${{ matrix.configuration }}-${{ matrix.sdk }}
Ephemeral Runner:一个任务一个 Runner
每个 job 都会在 Mac mini M4 节点上获得自己独立的一次性 ephemeral Runner:
- Runner 在任务开始时通过 JIT 配置向 GitHub 注册——Token 单次使用,约 60 分钟过期。
- 任务结束后 Runner 自动注销并移除——不会空闲驻留,也不会服务其他任务。
- 每个任务使用按任务隔离的工作目录,job 之间完全隔离:没有残留文件,没有跨任务污染。
这种"一任务一 Runner"的模式意味着并行 job 之间绝不共享状态,你每次拿到的都是干净环境。
Runner 注册:JIT + Ephemeral 模式
Runner 向 GitHub 的注册全自动化:控制面监听 workflow_job 事件、生成一次性 JIT Token 并下发注册指令——任何环节都不需要人工复制 Token。
| 维度 | Action 模式(手动,遗留) | App 模式(JIT ephemeral,默认) |
|---|---|---|
| 注册方式 | 人工到 GitHub 复制 Token,SSH 到机器执行 config.sh | 控制面监听 workflow_job → 生成 JIT Token → 自动下发注册指令 |
| Token 时效 | 长期注册令牌,泄露风险面大 | 一次性 JIT Token,约 60 分钟过期 |
| 生命周期 | 长期驻留,空闲也占 GitHub Runner 配额 | 单任务后自动注销,不占配额 |
| 标签 | 用户手动设置 | 控制面自动生成(平台 / 组织 / 套餐 / 机房四维) |
| 单机利用率 | 一机一个长期 Runner | 一机连续服务多个 Installation 的 ephemeral Runner |
| 卸载联动 | 无,App 卸载后 Runner 残留 | App 卸载 → 停止派单 → Runner 自然消亡 |
并发能力: 每台 Mac mini M4 最多可同时运行 2 个独立的 macOS 虚拟机(Apple 虚拟化许可上限),即可并行执行 2 个构建任务。配合 ephemeral Runner 即用即毁的模式,虚拟机资源在任务之间无缝复用,集群中每一台节点都在持续承接新任务——集群规模有多大,可用的并发能力就有多强。