跳至主要内容

第一次構建

了解你在 Macrunara 上的第一次構建,以及底層發生了甚麼。

構建生命週期​

當你推送程式碼 / 提交 PR 觸發 GitHub Actions 工作流程時,會發生以下完整過程:

1. 排隊與分配​

你的構建任務進入調度佇列,調度器依據節點分配標籤,結合以下條件分配 M4 運行節點:

  • 任務定義的硬件規格(M4 arm64)
  • 配置裡填寫的機房區域是否可用
  • 當前集群佇列負載情況
Status: Queued
Wait time: ~12 seconds

2. 環境準備​

分配到閒置 M4 運行節點後,節點開始準備編譯構建環境:

  1. 節點初始化:完成 M4 arm64 運行環境初始化
  2. Xcode 設定:啟用集群內可用的開發編譯工具版本
  3. 克隆存放庫:拉取專案完整程式碼
  4. 平台前置處理:完成身份合法性校驗,讀取任務裡設定的機房區域、最大運行時長等配置,生成運行過程資訊供頁面展示
  5. 依賴快取載入:載入專案構建依賴,首次構建即時拉取,任務結束同步至集群快取供後續重用

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. 產物收集​

構建業務步驟全部執行完畢後,運行節點完成平台側資訊回傳工作:

  1. 採集本次構建全程產生的控制台輸出日誌。
  2. 識別任務最終運行結果:成功、失敗、超時、取消。
  3. 將日誌內容與任務運行結果回傳,展示到操作頁面。

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 應用相關權限配置,確認存放庫授權、存取權限已完整開啟。

下一步​

完成第一次構建後,可以繼續探索: