2026-05-08 xcbeautify 與 結構化 xcodebuild 日誌：租用 Apple Silicon 雲端 Mac 上的 CI 門禁（香港／東京／首爾／新加坡／美國）

CI 很少死在編譯器「忘了怎麼編譯」——更多是死在 沒人讀得懂日誌。在香港、東京、首爾、新加坡或美國租用的 Mac mini M4 上，每條並行車道的 xcodebuild 輸出動輒數十 MB；若只堆原始文字，工程師要在 Xcode 冗長的編譯器橫幅裡 grep，佇列卻在空燒。xcbeautify 把洪流變成 單行、可 grep 的紀錄，且搭配 tee 不會藏失敗——你同時保留法務留存的原始稿與供自動化的正規化流。本 2026-05-08 指南串聯安裝釘版本、管道配置、result bundle 對齊與失敗分類，使門禁在 並行 xcodebuild 車道、DerivedData 隔離、自架 runner、覆蓋率門禁 與 磁碟衛生 旁維持確定。

2026 年可讀日誌為何仍卡發佈

Apple 工具鏈輸出的診斷會不可預期換行；CI 廠商以 HTML 檢視器補救，但純 SSH 租賃機仍需要稽核可用的 純文字佐證 與可 diff 的成品。xcbeautify 不取代 .xcresult 真值——它讓人類與正則先有機會，再開 xcresulttool。把美化日誌當 第一層；第二層仍是 junit 匯出引用的結構化 bundle。

遠端建構機上的雜訊與訊號

MacXCode 節點上三類老問題：

• stderr 順序遺失 — 封裝錯誤合併串流時尤其明顯。
• Unicode 邊角 — 本地化 clang 診斷須端到端 UTF-8。
• 並行扇出 — B 車道警告蓋住 A 車道致命錯的聚合視圖。

先做關聯再做美化：把 RUNNER_TRACKING_ID 或矩陣座標匯出到每條命令前綴，Slack 分片才能回到源車道。

安裝路徑：Mint、Homebrew 與語義釘

按組織標準選可重現安裝：

• Mint — 在 CI YAML 旁提交釘死的 Mintfile。
• Homebrew — 若在黃金建置後快照 brew list --versions 也可接受。
• curl | bash — 共用簽署機避免；可重現優於一時之快。

在手寫 runbook 中寫明二進位路徑，讓 launchd 與互動 shell 解析同一套二進位——PATH 抽籤就是「東京本機沒問題、新加坡翻車」的根因。

能堅持生產的管道與 tee

不要只把輸出 pipe 給 xcbeautify 卻不留原始日誌。健壯骨架：

set -o pipefail xcodebuild … 2>&1 | tee "${RAW_LOG}" | xcbeautify > "${PRETTY_LOG}"

pipefail 讓管道繼承 xcodebuild 的非零——即使 xcbeautify 常以 0 結束。明確設定 RESULT_BUNDLE_PATH，junit 步驟即可獨立於 stdout 粉飾讀取 .xcresult。送中央化日誌廠商時上游送 原始；送 GitHub Actions 摘要時送 美化。

grep 門禁：正則與 xcresult 真值配對

管線應及早攔截的自動化失敗基準：

模式族	grep 範例	後續
Clang 致命錯誤	grep -E "error: fatal error:"	xcresulttool 開啟 issue summary
簽署	grep -Ei "codesign|Provisioning profile"	對照鑰匙圈解鎖文件與車道隔離
模擬器	grep -E "SimRuntime|CoreSimulator"	參見模擬器留存策略

美化日誌讓這些 grep 更穩——仍要以 .xcresult 檢核 stderr 會說謊的脆弱 UI 測試。

並行車道：依車道關聯 xcbeautify 輸出

單主機多 xcodebuild 時為每行加車道前綴：

… | sed "s/^/[lane-${MATRIX}] /" | xcbeautify

沒有前綴時合併成品容易錯怪團隊——尤其統一記憶體在壓力下換頁會拖慢無關車道。並行建議對齊 並行任務調校。

留存、NVMe 與成品預算

每條 PR 同時存 raw 與 pretty 時日誌暴漲。建議：

• 依 DerivedData 指引 在隔離 TMPDIR 下建 每作業目錄。
• 分層留存 — raw 於物件儲存留 14–30 天；pretty 摘要 NVMe 留 7 天。
• 壓縮 — 跨區上傳前 zstd tarball。

若剩餘空間低於運維閾值，優先刪過期 pretty，再動與合規工單綁定的 .xcresult。

九步上線清單

1. 釘死 xcbeautify 並紀錄校驗和或套件版本。
2. 在 CI 包裝指令碼加入 pipefail＋tee 接線。
3. 將 xcresult 路徑寫入結構化後設資料 JSON。
4. 增加 grep 門禁與 Slack 嚴重等級路由。
5. 在消費日誌的 Windows／Linux 檢視器上驗證 UTF-8 解碼。
6. 帶前綴車道做並行浸泡。
7. 比較 raw 與 pretty 的 gzip 體積做預算。
8. 培訓值班閱讀 xcbeautify 與 raw。
9. 透過基礎設施 PR 推廣並備回滾 tarball。

SLO 表：租用建構機上的日誌健康

訊號	閾值	動作
缺失 raw 日誌成品	失敗建置中 任意 一次	阻斷發佈；修正 tee 路徑
grep 偽陰性	每 sprint > 2	調整模式並加 xcresult 斷言
磁碟成長斜率	週環比 > 18%	調留存或升級租賃 SKU

常见问题

問題	實操答案（2026-05-08）
Darwin 專用 xcbeautify 建置？	按 OS 釘 aarch64 bottle；避免 Rosetta 與原生二進位混車道。
能不要 raw 嗎？	不能——稽核與 Apple DTS 升級仍要未改動的完整紀錄。

為何 Mac mini M4 裸金屬利於日誌密集型 CI

順序寫日誌會與 APFS 後設資料爭用，而並行測試拉高 IOPS。MacXCode 各區的租用 Mac mini M4 NVMe 讓尾延遲可預期，tee＋xcbeautify 管道不致放大偶發紅。容量規劃可對照 區域定價 比較加機構與收緊留存；字元集問題需互動排查時參考 SSH／VNC 接入指南。