扇出拓扑 · 半同步识别 · 租约仲裁 · 重试预算 · 与 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 指标同样可验收。