許多團隊把 Mac mini M4 當作可排程建置節點租用後，能在映像裡裝好 Xcode 與模擬器，卻在 Runner「介面仍線上、憑證早已過期」的議題上耗費數週。本篇 2026-05-06 矩陣說明 註冊 TTL、LaunchAgent 身分偏移 與自動化 回收器（reaper） 在 Apple Silicon 上如何相互作用，讓佇列狀態真實可信；正文包含兩張決策表、八個與 JSON-LD 對齊的上線步驟，以及面向真實遙測的 FAQ——而不是「重開機直到變綠」的偏方。
建議與 Runner 註冊權杖生命週期、排空與維護交接 以及 並發與磁碟 SLO 下的池規模 搭配閱讀，避免身分修復與容量風暴在同一視窗相撞。
為何可排程 Mac 節點先在身分平面腐敗
與可拋棄的 Linux 虛擬機不同，專用 Mac CI 泳道攜帶大量有狀態膠水：使用者工作階段金鑰、忘記修剪的 APFS 快照，以及仍在靜默續期但編排器仍信任舊 Runner GUID 的 Git 憑證助手。在 Apple Silicon M4 上，統一記憶體往往讓 CPU 曲線看似空閒，而 git 詮釋資料密集型操作已經卡住——此時值班同仁習慣歸因「網路波動」而非「註冊幽靈」。正式的 TTL 加回收器能在財務追問「週二凍結為何佇列延遲翻倍」之前堵住觀測缺口。
- 映像後時鐘校準： NTP 修正牆鐘時間，但日誌裡的 LaunchAgent 標籤仍引用過時主機名。
- 手工重複設定： 工程師多次執行 configure，產生多個間歇性應答輪詢的註冊。
- 組織級 PAT 輪換： 自動化權杖已刷新，遺留 Runner 設定仍宣告廢棄權限範圍。
設計原則：新鮮度閘門應貼近佇列派發，而非僅僅寫在月度表格裡——若編排器無法證明 Runner 在 15 分鐘內碰觸過已認證端點，即使選單列圖示仍顯示線上，也應視為離線。
矩陣 A — 註冊工件 × 刷新節奏 × 偏移症狀 × 預設護欄
| 工件 | 刷新節奏 | 偏移症狀 | 護欄 |
|---|---|---|---|
| 臨時註冊 JWT | 每小時自動握手 | 工作在出隊後於簽出階段卡住 | 連續三次續約失敗後 Fail-close |
| 機器綁定 TLS 用戶端憑證 | 每 45 天輪換 | TLS 握手成功但 API 拒絕 Runner ID | 在 notAfter 前 14 天告警 |
| LaunchAgent 標籤 | 僅在 OS 大版本升級時變更 | 多個 Agent 爭搶同一權杖檔 | 每條泳道單一 plist 負責人並做校驗和閘門 |
| 儲存庫級憑證包 | 按迭代輪換 | 單元工作綠、整合拉取紅 | 在純編譯與部署泳道之間拆分 PAT 權限 |
矩陣 B — 維運異味 × 爆炸半徑 × 自動化回應
| 異味 | 爆炸半徑 | 回收器回應 |
|---|---|---|
| Runner 數量大於健康心跳數 | 排隊工作被釘在幽靈標籤上 | 對缺失心跳超過 SLA 兩倍視窗的 ID 執行註銷 |
| 磁碟將滿警告疊加輪詢風暴 | 殘缺日誌掩蓋認證失敗 | 對工作區做快照後原子回收註冊包 |
| DNS 重試激增 | 區域出口誤路由編排器呼叫 | 標記泳道降級並把流量切到次要區域節點 |
能扛住 Apple Silicon 雜訊的數字護欄
- 心跳預算：工作日每條泳道至少每 15 分鐘完成一次成功認證輪詢。
- 回收延遲：偵測到過時詮釋資料後，自動化清理須在 90 秒內結束，避免佇列依賴手工點擊。
- 身分偏移告警：當設定 Runner 持續十個採樣週期都比後端可見註冊多 1 台以上時立即告警。
八個上線步驟（與 JSON-LD 對齊）
- 盤點權杖：涵蓋組織、儲存庫與臨時 Runner 權限範圍。
- 定義過時訊號：用心跳、輪詢延遲與憑證日期，而非僅靠 ping。
- 自動化回收：稽核日誌須記錄哪位負責人批准破壞性刪除。
- 協調排空：與發布管理共用已文件化的凍結標籤。
- 重載 LaunchAgent：複製流程改動主機名稱或磁碟區 UUID 時必須執行。
- 校驗佇列：輪換後對每條泳道各跑一次快取建置與冷複製。
- 偏移告警：比對期望標籤與實際註冊。
- 季度稽核：刪除孤兒 Runner 列並收緊 TTL 預設值。
常見問題
臨時 Runner 還需要回收器嗎？
需要——映像指令碼在半拆解階段崩潰時，「臨時」承諾會失效；回收器可防止仍能輪詢的孤兒註冊拖累佇列。
Runner 設定是否應在磁碟靜態加密？
主機啟用 FileVault 並結合最小權限金鑰倉；共用 Mac CI 長凳絕不能只靠 chmod。
把 Mac mini M4 當作生產級 CI 容量，意味著同時尊重晶片能效與維運現實：Apple Silicon 在單一功耗信封內提供 CPU、GPU 與 NPU 餘量；原生 macOS 維持 iOS 團隊期望的工具鏈行為。NodeMac 在香港、日本、韓國、新加坡與美國提供 SSH 自動化與可選 VNC 應急，使你能不把硬體寫入 CapEx 的情況下隔離預生產與生產身分。按需租用專屬實體 Apple Silicon降低閒置叢集 TCO，並在 TTL 輪換高峰彈性擴展泳道——與上文矩陣配合，過時 Runner 將不再冒充健康容量。