第一次構建
了解你在 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 的參數與進階選項
- 快取加速後續構建
- 平行任務加快測試執行