扇出拓撲 · 半同步識別 · 租約仲裁 · 重試預算 · 與 Merge Queue 文檔分工閱讀
已在多臺遠程 Mac上跑共享 Runner、卻把IPA、dSYM、DerivedData 分層包交給「同事順手 scp」的團隊，常在凌晨遇到半同步：指針文件已指向新版本，字節尚未完整落地，消費節點卻已開始歸檔籤名。本文給出共享池扇出場景下 rsync 直傳與對象存儲的延遲與成本對照、manifest 雙欄位校驗與租約仲裁清單，並附六步可復現 Runbook。閱讀時可與Merge Queue 與 Runner 標籤、緩存就近與 artifacts 對照長文交叉，不必重複排隊策略細節。
當同一池子既要服務多個倉庫的夜間回歸，又要給交互式調試預留 CPU 餘量時，真正的瓶頸往往不在 GitHub 側隊列，而在字節扇出：一臺發布者 Mac 要在短時間內把數 GB 歸檔推給東京、新加坡與矽谷的消費節點。若仍沿用工程師筆記本時代的「誰方便誰傳」，你會得到不可解釋的 flaky：有時是鏈路抖動，有時是 UID 映射錯誤，有時是對象存儲最終一致性窗口裡讀到了舊 ETag。要把這類問題從玄學變成工單欄位，必須先承認扇出邊與計算邊是兩張不同的容量表。
單倉多節點的路徑相對直白：發布者與消費者隸屬同一製品命名空間，CI 變量可控。多倉爭搶同一 Runner 標籤時，複雜度躍遷——不同倉庫的緩存前綴、籤名身份與 retention 策略互相踩踏， bandwidth 爭用沒有統一觀測。此時若缺少租約仲裁（誰在什麼窗口獨佔 uplink），再好的 rsync 參數也會被並行作業打碎。本文刻意從 Mesh 視角寫只讀消費者契約：消費者永遠不允許反向寫回發布前綴，只能通過指針切換參與一致性，以降低密鑰擴散面。
與並發席位與互斥鎖 TTL一文的關係是：席位鎖解決「誰在同一時刻佔用編譯核」，本文解決「編譯完成後字節如何以可驗證方式離開這臺機器」。二者合併才是完整的共享池 Runbook。若你的團隊仍在混用交互會話與無人值守流水線，請先核對休眠策略與屏幕鎖定是否關閉了 SSH 控制通道，否則扇出作業會在人類眼裡的「剛剛還好」時刻無聲失敗。
隱藏帶寬債務：Merge Queue 深度健康但 Actions 隊列常年爆紅時，多半是可觀測性只看 GitHub 不看 cross-region_bytes。
半同步撕裂：指針先於對象就緒，消費者讀到殘缺 tarball，表現為 Codesign 或 LLVM bitcode 連結隨機報錯。
UID/GID 沼澤：rsync 保留屬性在多租戶共享卷上與 Provider 帳號模型衝突，產生「看得見文件但不能刪除」的殭屍目錄。
租約缺席：兩個發布作業同時寫同一 stage 前綴，後寫入者靜默覆蓋，清單哈希與真實字節不一致。
LIST 帳單：對象存儲被當成目錄樹頻繁枚舉，API 費用與延遲雙雙飆升，卻被誤歸為「蘋果工具鏈慢」。
下列維度按共享池扇出語境裁剪，而非通用雲架構教科書。若讀者數量少、路徑固定在運維可控的 SSH allowlist 內，rsync 配合 staged 指針通常 Total Cost of Ownership 更低；若讀者大於三且跨洋比例高，對象存儲加強一致讀策略（版本錨定而非裸 LIST）往往更穩。審計欄位剛性需求會把抉擇推向桶策略與不可變版本。
| 維度 | SSH rsync 直傳 | 對象存儲（S3 兼容） |
|---|---|---|
| 延遲輪廓 | 隨 RTT 線性，適合「少量大塊」；可配合壓縮與並行切片 | 首字節受 DNS、TLS 與區域入口影響；適合多讀者並行拉取 |
| 成本模型 | 主要為運維時間與鏈路機會成本；夜間搶佔帶寬可能拖累交互用戶 | 出站 GB、請求次數與生命周期分層共同決定帳單；LIST 是隱形殺手 |
| 審計與合規 | 依賴 SSH 日誌與 rsync 模塊 ACL；跨區域拷貝要自己記帳 | 桶策略、訪問日誌、對象鎖與跨區域複製策略成熟 |
| 故障面 | TCP 會話中斷、partial 文件、密鑰輪換窗口 | 憑證洩漏面、公開讀誤配、最終一致性讀錯版本 |
| 半同步風險 | inplace 寫入若缺臨時目錄隔離，讀者可見撕裂文件 | 指針切換早於 multipart complete 會產生幽靈 manifest |
先決定扇出拓撲與租約，再挑選傳輸語法；順序反了會在指標面板裡看到「CPU 很閒但隊列爆炸」的假性健康。
以下步驟假設你已按共享池 SSH 與 Runner 編排完成主機互信；若尚未拆分 ci-merge 標籤，請同步閱讀 Merge Queue 文以免扇出優化被合併飢餓抵消。每一步結束應有可機器校驗的產出物，而不是口頭「搞定」。
凍結髮布三元組：commit 短 SHA、構建號、工具鏈指紋寫入 manifest.header，任何 rebuild 必須 bump 構建號。
申請 uplink 租約：向調度註冊扇出窗口與預計字節數；租約 ID 寫入日誌與 stage 目錄名。
寫入 stage 前綴：僅允許臨時路徑接收字節；禁止 consumers 訂閱 stage 通配符。
雙欄位校驗：manifest 同時列出 tarball SHA-256 與「邏輯大小」；二者任一不匹配即阻斷指針切換。
原子切換：指針文件或 latest 標籤只在校驗門禁通過後更新；更新動作單獨審計。
扇出重試預算：指數退避上限、全局超時與死信隊列寫入 runner 日誌，避免無聲吞失敗。
RSYNC_RSH="ssh -o ServerAliveInterval=25 -o ServerAliveCountMax=3"
/usr/bin/rsync -az --partial --temp-dir="/var/tmp/rsync-stage-${LEASE_ID}" \
./publish/${BUILD_ID}/ consumer@${HOST}:inbox/stage/${BUILD_ID}/
提示：高抖動鏈路可為 SSH 配置 ServerAliveInterval 並結合分段 tarball；若下遊要求毫秒級一致性切換，優先對象存儲 multipart 完成事件驅動指針。
消費者節點應掛載只讀憑證拉取對象或 rsync 模塊，禁止持有發布私鑰。跨洋大包建議拆分「代碼產物」與「調試符號」兩條鏈路：前者走高頻小對象與 CDN 友好路徑，後者可走異步夜間帶寬窗口。若你在消費側仍運行 Xcode 交互編譯，請避免把 DerivedData 同步回發布前綴，否則會破壞緩存鍵單調性。
籤名校驗失敗時，優先比對 manifest 工具鏈段與消費機 xcode-select 路徑，再回到字節完整性；半數所謂「蘋果升級壞了」實為半同步讀。與SSH 與 VNC 接力對照閱讀時，請記住交互鏈路帶寬預算通常比扇出鏈路寬鬆一個數量級，不要混用閾值。
若你們在消費側啟用並行 XCTest 或 UI 錄製回放，磁碟寫入會與扇出讀交錯產生 IO 排隊；這時僅用 CPU 利用率判斷健康會誤判。建議把 iostat 或等價指標的寫延遲併入同一 Grafana 行，與 cross_region_bytes 並列展示，才能在復盤會上五分鐘內向管理層解釋「為何昨夜擴容 CPU 仍然失敗」。對象存儲路徑還要區分強一致讀與最終一致讀客戶端封裝：後者在跨區域複製開啟時常見五分鐘級漂移窗口，切勿把它當成 Runner 本身的 flaky。
冪等與構建號的映射應當寫入調度信封而非散落在 shell 片段；當 webhook 或定時觸發重複投遞同一構建產物任務時，若無去重鍵，stage 目錄可能被並行清空然後重寫，從而放大半同步概率。任務鏈可觀測一文中討論的 envelope 欄位可直接復用到扇出門禁。
注意：清理 stage 目錄前必須確認租約釋放且無消費者持有文件句柄；暴力 rm -rf 是高風險運維動作，應納入雙人覆核清單。
消費門檻：拉取前校驗租約狀態為 released 且指針世代單調遞增。
失敗分層：網絡類錯誤可重試；校驗類錯誤必須阻斷並打開 incident。
回滾指針：保留上一世代 manifest 至少兩個發布周期以便秒級退回。
下列區間為立項評審與容量復盤使用，不代表 SLA；請用你們真實直方圖替換預設值並保留採樣窗口說明。評審時應要求負責人同時交出「隊列深度」「磁碟寫延遲」「扇出字節速率」三條曲線，缺一不可；缺任一曲線默認該項風險未關閉。
對混合 AI Agent 負載的團隊，夜間扇出窗口可能與模型批量推理爭用同一節點的 PCIe 與內存帶寬；這時需要在編排層顯式標註優先級或拆分主機角色，否則 GPU 輕負載也可能拉高磁碟 subsystem 延遲並傳導到 rsync。此類耦合很難靠單機指標孤立識別，需要統一的容量主題例會把 Agent、CI、扇出三張卡片貼在同一白板上討論。
| 讀者拓撲 | 跨洋佔比 | 首選起步方案 |
|---|---|---|
| 1→2 同城 | < 10% | rsync + stage + manifest 雙欄位；SSH keepalive 固定 |
| 1→4 多岸 | 40–70% | 對象存儲不可變版本 + 錨定讀；LIST 改為清單索引 |
| 多發布者多消費者 | 任意 | 強制租約仲裁 + 單獨 observability 面板；禁止共享 stage 根 |
依賴個人設備與臨時帳號做扇出，會在密鑰輪換、休眠策略與審計三方同時欠帳；即便算法正確，底層節點不可用也會讓命中率與隊列深度失真。相較之下，需要合同化節點與可覆核帶寬的團隊更適合把討論建立在可訂購的雲 Mac 上。
自建機房固定資產往往被採購周期與折舊綁架；借用零散筆記本又無法滿足多地並發與籤名隔離。對要把iOS 與 macOS 持續交付與AI Agent 夜間任務放在同一容量故事裡的團隊，VpsMesh 的 Mac Mini 雲端租賃通常是更優解：區域可選、節點專用、鏈路可審計，讓扇出指標與 Runner 指標同樣可驗收。