第一次构建
了解你在 Macrunara 上的第一次构建,以及底层发生了什么。
构建生命周期
当你推送代码 / 提交 PR 触发 GitHub Actions 工作流时,会发生以下完整过程:
1. 排队与分配
你的构建任务进入调度队列,调度器依据节点分配标签,结合以下条件分配 M4 运行节点:
- 任务定义的硬件规格(M4 arm64)
- 配置里填写的机房区域是否可用
- 当前集群队列负载情况
Status: Queued
Wait time: ~12 seconds
2. 环境准备
分配到空闲 M4 运行节点后,节点开始准备编译构建环境:
- 节点初始化:完成 M4 arm64 运行环境初始化
- Xcode 设置:启用集群内可用的开发编译工具版本
- 克隆仓库:拉取项目完整代码
- 平台前置处理:完成身份合法性校验,读取任务里设置的机房区域、最大运行时长等配置,生成运行过程信息供页面展示
- 依赖缓存加载:加载项目构建依赖,首次构建实时拉取,任务结束同步至集群缓存供后续复用
3. 步骤执行
按照工作流配置文件内步骤顺序依次执行:
steps:
- name: Checkout # 1. 拉取项目代码
- name: Macrunara Setup # 2. 身份校验、读取配置、输出运行信息
- name: Install Deps # 3. 安装项目依赖
- name: Build # 4. Xcode 编译项目
- name: Test # 5. 执行单元测试
- name: Upload Artifacts # 6. 上传构建产物
4. 产物收集
构建业务步骤全部执行完毕后,运行节点完成平台侧信息回传工作:
- 采集本次构建全程产生的控制台输出日志。
- 识别任务最终运行结果:成功、失败、超时、取消。
- 将日志内容与任务运行结果回传,展示到操作页面。
5. 清理
单次构建结束,运行节点执行环境清理:
- 内存中密钥信息安全擦除
- 构建产生的临时文件删除
- 本次构建会话环境销毁,等待接收下一个 CI 任务
构建状态
| 状态 | 描述 | 需要的操作 |
|---|---|---|
| Queued | 等待分配 M4 运行节点 | 无,等待调度 |
| Running | 节点正在执行构建步骤 | 查看 GitHub Actions 日志 |
| Success | 全部步骤执行通过 | 无,查看产物与测试报告 |
| Failed | 至少一个步骤执行失败 | 查看日志定位报错 |
| Canceled | 工作流被取消(手动、API 或平台触发) | 无 |
| Timed Out | 超出任务设置的最大运行时长 | 优化构建,调大最大运行时长参数 |
阅读构建日志
构建日志带有步骤前缀结构化输出,在 GitHub Actions 工作流详情页查看:
[00:02:15] [Checkout] Cloning repository...
[00:02:18] [Macrunara-Setup] 身份校验完成,机房区域:auto,最大运行时长:30
[00:02:18] [Install] Running 'pod install'...
[00:02:45] [Install] Dependencies installed
[00:02:45] [Build] Starting xcodebuild...
[00:06:12] [Build] Build succeeded
[00:06:12] [Test] Running XCTest...
[00:08:45] [Test] All tests passed
首次构建常见问题
问题:Xcode 版本不匹配
现象:构建时报找不到编译工具、接口语法报错。
解决方案:确认集群已提供的工具版本,在工作流中选用集群支持的 Xcode 版本。
问题:身份校验不通过,任务无法进入节点
现象:任务一直排队,直接报错终止,无法分配运行节点。
解决方案:检查 GitHub 应用相关权限配置,确认仓库授权、访问权限已完整开启。
下一步
完成第一次构建后,可以继续探索:
- Setup Action 的参数与高级选项
- 缓存加速后续构建
- 并行任务加快测试执行