2026年 Python CI：uv・PyPI ミラー跨境一括取得の決定マトリクス

判断は「解像度の単位」と「キャッシュ再利用」です。単一リポで pyproject.toml または requirements 系列を CI の正にできるなら uv が最も扱いやすいです。

uv を優先する条件（チェックリスト）：（1）uv.lock または requirements.lock をリポジトリにコミットできる。（2）Runner が Apple Silicon／x86_64 のどちらかに固定できる。（3）社内 PyPI ミラーまたはプロキシ方針がチームで共有されている。

デフォルト（読取 30s・再接続 10s・再試行 3）は跨境ジョブでは短めです。帯域とジョブ wall-clock を見ながら まず HTTP を伸ばし、次に並列数を上げます。

export UV_CACHE_DIR="$HOME/Library/Caches/uv-ci/$CI_PIPELINE_ID"
export UV_DEFAULT_INDEX="https://pypi.org/simple"
export UV_HTTP_TIMEOUT=180
export UV_HTTP_CONNECT_TIMEOUT=45
export UV_HTTP_RETRIES=8
export UV_CONCURRENT_DOWNLOADS=12
export UV_CONCURRENT_INSTALLS=4
export UV_CONCURRENT_BUILDS=2
uv --version

export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"
# 検証後、公式へ戻す
export UV_DEFAULT_INDEX="https://pypi.org/simple"

export HTTPS_PROXY="http://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1,pypi.internal.example"
export UV_NATIVE_TLS=1

ロックは「更新 PR」と「インストールジョブ」を分離します。CI 本番は 常に frozen、バンプは開発者マシンまたはボットで uv lock だけが書き換わるようにします。

• 1. Python 版固定：uv python pin 3.12 または .python-version をコミット。
• 2. ロック鮮度：pyproject.toml 変更は uv lock 専用 PR に限定し、CI 本番は uv sync --locked のみ（齟齬があれば失敗）。
• 3. 同期：uv sync --locked --no-dev（本番相当）。
• 4. requirements 派生：uv pip compile pyproject.toml -o requirements.lock → uv pip sync requirements.lock。
• 5. ログに uv --version と UV_DEFAULT_INDEX のホスト名のみ（認証情報は出さない）を出す。

env:
  UV_HTTP_TIMEOUT: "180"
  UV_HTTP_RETRIES: "8"
  UV_CONCURRENT_DOWNLOADS: "12"
  UV_CACHE_DIR: /tmp/uv-cache-${{ github.run_id }}

キャッシュ汚染： 共有 Runner では UV_CACHE_DIR をパイプライン ID で分離。異常時のみ UV_NO_CACHE=1 で切り分け。

プラットフォーム wheel： ロック生成環境と CI の OS／アーキテクチャ／Python を一致させる。Apple Silicon リモート Mac なら arm64 前提でドキュメント化。

私有インデックス混在： UV_DEFAULT_INDEX を社内ミラーにし、公開パッケージは UV_INDEX で PyPI を追加するか、tool.uv.index で名前と URL を宣言。UV_INDEX_STRATEGY は first-index など監査に合う値に固定し、unsafe-best-match は必要最小限に。

構造化データの FAQPage と同内容を短く要約しています（検索snippet 用）。

並列数を上げる前に UV_HTTP_TIMEOUT／UV_HTTP_RETRIES を伸ばし、UV_CACHE_DIR でキャッシュ境界を決めると、リモート Mac でも再現性とスループットの両立がしやすくなります。同系列の Rust・Cargo マトリクスや Git／Homebrew／npm プル安定性 FAQと併せて運用ルールを揃えると、パイプライン全体が安定します。