二〇二六年 リモート Mac CI：pnpm store-dir × Turborepo Remote Cache越境命中率と registry ミラー決定マトリクス

越境リモート Mac CIでは「速い／遅い」より再現可能な hit 率を先に固定します。ジョブ要約に次の四指標を載せ、週次で閾値を見ます。

pnpm storeは runner ローカル SSD に置き、復元キーは lockfile と Node 版とアーキテクチャで切ります。テナント共有 Mac では store を混ぜません。

# .npmrc（リポジトリ直下・CI とローカルで同一）
store-dir=/var/ci/pnpm-store/v3
registry=https://registry.npmmirror.com
network-concurrency=12
child-concurrency=4
fetch-timeout=120000
fetch-retries=3
fetch-retry-mintimeout=4000
fetch-retry-maxtimeout=90000

@myorg:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_PACKAGES_TOKEN}

越境では Vercel 既定 CDN より自社リージョンの cache サーバが hit 安定しやすいです。TLS 終端とトークン輪替を Runbook に載せます。

// turbo.json 抜粋
{
  "$schema": "https://turbo.build/schema.json",
  "remoteCache": { "enabled": true },
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**"],
      "env": ["NODE_ENV", "NEXT_PUBLIC_*"]
    },
    "lint": { "outputs": [] }
  }
}

export TURBO_API="https://turbo-cache.internal.example:443"
export TURBO_TOKEN="${TURBO_CACHE_RW_TOKEN}"
export TURBO_TEAM="prod-monorepo"

TLS は社内 CA または公開証明書を明示し、NODE_EXTRA_CA_CERTS を runner イメージに焼き込みます。トークンは read と write を分離し、輪替期間は二トークン併存を一パイプラインサイクル確保します。

npm と Git を別表で固定し、turbo run build --filter=...@scope/pkg でジョブ分割します。越境跨境拉取は install と turbo を別 runner プールに分けると切り分けが速くなります。

pnpm config set store-dir "$CI_PNPM_STORE"
pnpm install --frozen-lockfile --prefer-offline

turbo run lint test build \
  --filter='...[origin/main]' \
  --concurrency=8 \
  --summarize

ミラー詳細は 越境 Git／npm／Homebrew 最適化・Yarn Berry 決定表を参照してください。

Turborepo の cache hit がゼロに近いです。

remoteCache.enabled、TURBO_TEAM、環境変数の差分、--filter 範囲を確認し、hash 入力に OS と Node 版を含めてください。

pnpm store がジョブ間で汚染されます。

store-dir をテナント単位に分離し、復元キーに pnpm-lock.yaml のダイジェストと Node 版を必ず含めてください。

registry ミラーで 429 が続きます。

network-concurrency と turbo worker を下げ、四から九十秒の段階退避を入れ、GitHub Packages 認証を npm 本体と分離してください。

pnpm store・Turborepo remote cache・registry ミラーを一枚の決定表に固定すると、越境 runner の再現性が上がります。