跳到主要内容

并发与矩阵构建

利用 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 即用即毁的模式,虚拟机资源在任务之间无缝复用,集群中每一台节点都在持续承接新任务——集群规模有多大,可用的并发能力就有多强。