2026 モノレポ
モノレポ避坑:
リモートMac・キャッシュとミラー三歩
2026.03.24
フロント・モノレポ向け
約 7 分
リモートMacでモノレポを回す方向け。ローカル保管とリモート保管、ミラー切替えリスクを表で比較し、環境変数・turbo.json・CI の三層で再現性を揃えます。
01 つまずき三つ
02 キャッシュ比較表
置き場所で初回と二回目以降の待ちが変わります。
| 観点 | ローカル | リモート |
|---|---|---|
| 初回 | 手軽 | 認証要 |
| 二回目以降 | 同一端末で速い | 他端末・CIも再利用 |
| 容量 | 重複しやすい | 集約で軽く |
| 安全 | 端末内 | 権限設計必須 |
03 ミラーリスク表
取得元を変えると再現性に効きます。
| リスク | 内容 | 対策例 |
|---|---|---|
| 中身差 | 版表記同でも tarball が違う | 切替後クリーン取得 |
| ロックずれ | 解決結果が変わる | CIと端末で取得元固定 |
| 認証 | ミラーごとに制限違い | 秘密情報を揃え方針を文書化 |
04 実行五手順(変数・turbo・CI)
リモートでも手元に近づける順序です。
- 環境変数:ストアパス・取得元URL・リモートキャッシュ用トークンをプロファイルとCI秘密に集約し同名で参照。
- リンク方針:ワークスペースの解決ルールをREADMEに固定し新規も同手順で導入。
- turbo.json:成果物パス・入力・
passThroughEnvを宣言しキー漏れをレビュー。 - CI整合:ランタイム版・パッケージマネージャ版・インストールフラグ・キャッシュキーを端末と同一化。
- 検証:ミラー変更後はクリーンフルビルドしログで再利用率を確認。
併読:デプロイと実機検証三歩。
05 判断材料
- ストア統一で跨リポジトリの再利用が安定。
- ヒット率はログで週次ざっと確認。
- ミラー切替のたびロックと実体を規約で確認。