场景边界
cron 扇出可行条件：单一运维账号、任务短且幂等、每入口 flock 包临界区并设墙钟上限、接受分钟级抖动。出现多小队投递、CI 与人共道、或要优先级/公平时，应按队列产品治理，而非继续加 crontab。
Nomad 式调度适合用约束键表达「单 codesign 车道」「解析与 archive 分车道」等，并把重启/重调度写进规格；控制面多在机外，Mac 作执行端。扩到第二台时对齐队列与部署，见 多节点部署与任务队列同步。
两任务可能写同一可变目录却无锁域文档，即已进入队列领地。占座、VNC 与 CI 抢桌面等社交故障见 占座锁与队列 FAQ。
队列模型对比表
下表是运维合同：值班能否少读 crontab 仍推断行为。
| 维度 | cron 扇出 + 包装脚本 | Nomad 式轻量队列 |
|---|---|---|
| 首跑延迟 | 受 cron 周期约束（常见 60s）；缩短周期增大羊群效应。 | 事件/队列拉取；预热 Worker 时 p50 常 <1min。 |
| 并发控制 | 手工：每脚本 flock、进程计数或外部 Redis——易漂移。 |
声明式：count、spread、亲和；上限集中。 |
| 抢占 / 隔离 | 缺省无，除非自建信号；「杀掉长跑」常停留在口耳相传。 | 重启/重调度/优先级；allocation 可审计。 |
| 状态与可观测 | 日志分散；跨脚本关联 ID 难一致。 | 中心化 job 历史；标准标签（job、alloc）便于指标。 |
| 运维负担 | 安装轻、团队变大后漂移成本高。 | 前期重、第五名工程师加入后意外更少。 |
| 典型故障形态 | 静默重叠 + 缓存损坏。 | 约束建错致饿死——改规格而非靠群聊。 |
可执行配置要点（cron 收紧）
单车道、显式锁等待、拒绝无限堆叠：
# /etc/crontab 片段 — 仅 buildlane 用户
*/1 * * * * buildlane /usr/bin/flock -n /var/run/meshmac/build.lane.lock \
timeout 45m /usr/local/bin/run-ci-dequeue.sh >>/var/log/meshmac/dequeue.log 2>&1出队脚本顶部检查队列深度：>20 则退出码 77 并告警。锁细节见 flock FAQ。
可执行配置要点（Nomad 式周期 batch 示意）
控制面在机外；run-ci-dequeue.sh 内 SSH/Runner 落到 Mac，策略收束在单一 job：
job "meshmac-mac-build" {
datacenters = ["dc1"]
type = "batch"
periodic {
cron = "*/2 * * * *"
prohibit_overlap = true
}
group "lane" {
count = 1
task "dequeue" {
driver = "exec"
config {
command = "/usr/local/bin/run-ci-dequeue.sh"
}
resources {
cpu = 500
memory = 512
}
restart {
attempts = 3
interval = "30m"
delay = "30s"
mode = "delay"
}
}
}
}单 archive 车道须 prohibit_overlap = true；Xcode 步骤集中在 dequeue 脚本，勿散落多份 crontab。
权限与锁
调度只管调度；权限归 macOS。非交互用专用 buildlane，钥匙串只给该账户；LaunchDaemon 用 sudo -u buildlane，勿 root 跑 Xcode。
- 锁粒度：按共享资源（Pods、npm、Simulator 槽）分锁，避免一颗锁串死全机。
- 元数据：锁旁 JSON 记
job_id、commit、runner_name。 - 清理：杀任务时
trap收半成品.xcarchive并放锁，防孤儿目录。
构建冲突验收清单
- ☐ 同一路径 checkout 上两次并行 dry-run 无写重叠，或重叠段在 120s 内的 flock 包裹内。
- ☐ CI 与手工脚本共用同一出队入口，不存在绕过队列的「隐身」cron。
- ☐ 锁等待中位数低于对外 SLA；p95 超过 15 分钟触发告警。
- ☐ 强杀运行中任务后无陈旧 flock 持有者（校验 PID 后文档化解锁步骤）。
- ☐ 连续五晚 archive 后磁盘空闲仍 >15%，否则扩车道或加节点。
超时退避参数
下列数值抄进内部 runbook，再按实测 p95 构建时间微调。
| 参数 | cron + shell 基线 | Nomad 式基线 |
|---|---|---|
| 单任务墙钟 | timeout 45m 轻车道；重 archive 试 90m。 |
任务 kill_timeout 对齐同档；勿对 Xcode 保留默认 30s。 |
| 锁等待 | 包管理器段 flock -w 180；超时快速失败并打点。 |
等待写在 worker 脚本；调度重启避免忙等，最小 delay = "30s"。 |
| 重试退避 | 指数：30s、60s、120s 封顶；乘 0.8–1.2 抖动。 |
reschedule：max_delay = "5m"，delay_function = "exponential"。 |
| 全局待处理上限 | 每车道 pending ≤20；拒绝时返回可行动的 HTTP/退出码。 | 提交端与队列双侧强制；Nomad 不替你猜业务 SLA。 |
重试前可加抖动：sleep $((30 + RANDOM % 30))；日志带 attempt、next_backoff_s、reason。
FAQ
问：是否必须在每台共享 Mac 上安装 Nomad？
不必。许多团队在 Linux 上跑调度器，Mac 仅作远程执行端。重要的是一份声明式合同描述重叠、重启与历史，而非品牌。
问：cron 更简单，队列为何仍爆炸？
安装简单不等于稳态简单。无中心深度上限会产生隐性积压；缩短 cron 周期只会把更多进程赶进同一把锁。
问：首跑延迟与退避怎么量、怎么对齐 CI？
cron 常分钟级；dispatcher+队列在控并发下可亚分钟。度量「提交→开始」p50/p95，p95 超基线两倍告警。shell 重试仅用于幂等段、指数封顶加抖动；Nomad reschedule 的 max_delay 宜小于 CI 可见超时之半，避免挂死到全局 job 超时。