共有リモートMac：Nomad 式軽量キュー vs cron 扇出

cron 扇出は、(1) エントリを単一の運用アカウントが管理し、(2) 各ジョブが短く冪等、(3) クリティカル区間を flock と壁時計上限で囲み、(4) 分単位のジッターを許容できるときに妥当です。複数スカッドが投入し、CI と人間が優先度・公平性を争う段階では、cron だけでは「誰が CPU を取っているか」が属人化します。

Nomad 型（HashiCorp Nomad そのものでも、同じ概念のオーケストレータでも可）は、「アーカイブはホストあたり1本」「SwiftPM 解決は2並列まで」のように制約キーごとの最大並列を宣言し、再起動・再配置を HCL 等に残せる点が価値です。Mac は実行端末、スケジューラは退避しやすい OSに置くのが現実的です。境界の線引きはシンプルで、同一の可変ディレクトリをドキュメント化されたロック領域なしに触れる経路が2本あるなら、すでに「キュー＋ロック」の設計対象です。

深夜のオンコールがcrontab を12個読まずに状態を復元できるかが、運用コントラクトです。

実行可能な設定要点（コピー用）

cron：単一レーン・非ブロッキング flock 拒否ではなく待ちを使い分け、壁時計は timeout で必ず殺す。

# 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

dequeue 先頭で待ち深度を検査：Redis リストや SQLite キュー長が 20 を超えたら exit 77 でページ（クライアントを吊り下げない）。

Nomad：物理アーカイブ1本に対応する periodic には prohibit_overlap = true。実処理は run-ci-dequeue.sh 内で Mac へ SSH／Runner API。

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"
      }
    }
  }
}

スケジューラは並べるだけで、macOS の権限境界は別問題です。非対話ビルドは buildlane 等の専用アカウントに寄せ、コード署名はそのキーチェーンだけに閉じます。root の LaunchDaemon からは sudo -u buildlane で Xcode を起動してください。

• ロック粒度：Pods／npm キャッシュ／シミュレータ枠など共有資源ごとに .lock。ディスク全体を1ロックにするのは意図的直列化のときだけ。
• メタデータ：ロック旁に job_id・commit・runner_name の JSON を置き、オンコールが「まだ誰の所有か」を読めるようにする。
• 先奪後の掃除：割当 kill 時は trap で部分 .xcarchive とロック解放。スケジューラが再試行してもディスクが孤児で埋まらないようにする。

ビルド衝突の検収チェックリスト

• ☐ 同一チェックアウトでドライラン2本が書き込み競合なし（または flock 区間120秒以内）。
• ☐ CI と手動が同じ dequeue 入口のみ通る（バイパス cron なし）。
• ☐ ロック待ちの中央値が社内 SLA 内、p95 > 15分ならアラート。
• ☐ 実行中ジョブ kill 後にゾンビ flockが残らない（PID 確認と解除手順が Runbook にある）。
• ☐ 夜間アーカイブ5連続後も空き容量 > 15%。満たせなければレーン分離またはノード追加。

以下は出発点です。p95 ビルド時間の実測で上書きしてください。

bash 5+ のジッター例：sleep $((30 + RANDOM % 30))。各分岐で attempt・next_backoff_s・reason をログに残し、ダッシュボード検索を単調に保ちます。

Mac 本体に Nomad が無いとダメ？

いいえ。制御面を Linux に置き Mac を実行端末にするのが一般的です。ブランドより宣言的な重複禁止と履歴が目的です。

cron の方が簡単なのに、なぜキューが爆発する？

導入時の簡単さと、定常運用の簡単さは一致しません。扇出に中央の深度上限がないと隠れバックログが増え、周期を詰めると同じロックへ群がります。

flock だけで Nomad は不要？

直列化には有効ですが、優先度・履歴・複数ホスト間の整合は別レイヤです。第二台目を足すならスケジューラまたは単一の dequeue デーモンに寄せた方が説明が楽です。