2026年 Deno・JSR 跨境依存取得の決定マトリクス

軸は「ホップ数」と「ロック逸脱の許容度」です。混在（jsr:＋npm:）は切り分け対象が増え、共有 DENO_DIR はキャッシュ汚染を招き、--reload 常用は再現性を壊します。

jsr: は JSR、npm: は npm レジストリ、https: は直 URL です。跨境では TLS／プロキシ経路がホストごとに異なるため、README にレジストリ方針を書きます。

既定は ~/Library/Caches/deno 付近です。CI では DENO_DIR にジョブ ID を含め、deno.lock を正とします。

export DENO_DIR="$HOME/Library/Caches/deno-ci/${CI_PIPELINE_ID:-local}"
export DENO_TLS_CA_STORE=system
deno --version
deno install --frozen

跨境では timeout を先に広げ、次に max-parallel です。max-parallel は 2〜4 から、timeout-minutes は初回取得込みで 25〜45 分帯が目安です。

• 1. deno cache を単独ステップにする。
• 2. deno install --frozen でロック逸脱を検知。
• 3. キャッシュキーにロックハッシュと Deno 版。
• 4. 再試行は最大 3 回・2s／4s／8s のバックオフ。

strategy:
  max-parallel: 3
env:
  DENO_DIR: /tmp/deno-${{ github.run_id }}
# job:
timeout-minutes: 35

Q. すぐ --reload？　A. 先に TLS／プロキシを確認。ロックを保ったままバックオフ付き deno cache を推奨します。

Q. npm: だけ遅い？　A. tarball と RTT です。ミラー寄せと jsr: 置換候補を README に書きます。

Q. 取得できたのに古い？　A. DENO_DIR 取り違え。ID 付きパスとロックハッシュ付きキャッシュキーで統一します。

経路を表にし、DENO_DIR と deno.lock で境界を切ると再現性が上がります。Python・uv マトリクス、Go・GOPROXY マトリクスと併読してください。