こんにちは！日々の開発、本当にお疲れ様です。
Pythonでの開発、楽しいですよね。豊富なライブラリのおかげで、数行書くだけで高度な機能が実装できてしまう。本当に素晴らしいエコシステムです。
しかし、いざ作ったアプリケーションをAWS Lambdaなどのサーバーレス環境やDockerコンテナにデプロイしようとしたとき、こんな絶望感を味わったことはありませんか？
「あれ……？ `pip install` しただけなのに、デプロイパッケージが 300MB もある……？」
「Lambdaのコールドスタート（初回起動）に数秒もかかっている……これじゃユーザーが離脱してしまう……」
Pythonのパッケージ管理において、依存関係の肥大化とデプロイサイズの増大は、避けて通れない永遠の課題でした。特に `pip` や従来の `poetry` では、不要なキャッシュやビルドアーティファクトまで巻き込んでしまいがちです。
ですが、安心してください。今日ご紹介する次世代の高速パッケージマネージャー `uv` を使えば、この悩みは劇的に解決します。
今回は、`uv` の強力なアーカイブ機能を駆使して、Pythonの配布物サイズを限界まで削ぎ落とし、デプロイとコールドスタートを爆速化する手法を、優しく丁寧にお伝えしていきますね。これをマスターすれば、あなたのサーバーレスライフは劇的に快適になりますよ！
—
なぜPythonのデプロイサイズは膨らむのか？（そしてなぜ `uv` なのか）
まずは、敵を知ることから始めましょう。なぜ従来の `pip` や仮想環境（`.venv`）をそのまま固めてデプロイすると、サイズが巨大になってしまうのでしょうか？
1. 不要なファイルまで同梱される: `.pyc` ファイル、テストコード、ドキュメント、ビルド時のキャッシュなど、「実行時（プロダクション）には1ミリも使わないファイル」が大量に含まれます。
2. 解決の遅さと不確実性: 依存関係のツリー解決に時間がかかり、CI/CDのビルド時間が長引きます。
ここで登場するのが、Rust製で驚異的な速さを誇るAstral社製のツール `uv` です。
`uv` は単に `pip` の数倍速いだけではありません。「プロジェクトの依存関係を完璧に静的解決し、本番環境に必要な純度100%のファイル群だけをクリーンにパック（アーカイブ）する機能」を持っています。これを利用すれば、無駄な容量を極限まで削ぎ落とした「超軽量パッケージ」を作ることができるのです。
—
1. `uv` のインストールと基礎セットアップ
まずは、あなたの手元の開発環境に `uv` を迎え入れましょう。インストールは驚くほど簡単です。ターミナルを開いて、以下のコマンドを実行してください。
macOS / Linux の場合
公式のインストーラーを安全にダウンロードして実行します
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell) の場合
PowerShell環境での標準的なインストールコマンドです
powershell -c “irm https://astral.sh/uv/install.sh | iex”
インストールが完了したら、正しく入っているか確認してみましょう。
uv –version
> 実行ログ例: `uv 0.5.x (or later)` のようにバージョンが表示されれば成功です！
—
2. HelloWorld：プロジェクトの初期化と依存関係の定義
それでは、実際に軽量化デプロイメントのデモ環境を作ってみましょう。今回は、軽量なWebフレームワークとして人気の `FastAPI` を例にします。
任意の作業ディレクトリを作り、そこで `uv` を初期化します。
プロジェクト用のディレクトリを作成して移動
mkdir uv-lambda-demo
cd uv-lambda-demo
プロジェクトを初期化（pyproject.tomlが生成されます）
uv init –app
生成された `pyproject.toml` を覗いてみてください。非常にシンプルな設定ファイルが作成されています。ここに、今回のアプリケーションで使用する依存関係を追加します。
今回は、Lambdaや軽量コンテナを想定して、以下の2つだけを依存関係に入れましょう。
- `fastapi`: Webアプリケーションフレームワーク
- `mangum`: ASGIアプリをAWS Lambda（API Gateway等）で動かすためのアダプター
以下のコマンドを実行すると、`uv` が瞬時に依存関係を解決し、ファイルを書き換えてくれます。
依存関係としてfastapiとmangumを追加
uv add fastapi mangum
これで、プロジェクトの基礎セットアップは完了です！
—
3. アプリケーションの実装（最小限の動作確認コード）
動作確認用のコードを書きましょう。プロジェクトのルートディレクトリに `main.py` を作成し、以下のコードを記述してください。
`main.py`
from fastapi import FastAPI
from mangum import Mangum
FastAPIのインスタンス化
app = FastAPI(title=”Uv Optimized Lambda Demo”)
@app.get(“/”)
def read_root():
“””
ヘルスチェックやルートアクセス用のシンプルなエンドポイント
“””
return {“message”: “Hello from uv-optimized Python deployment!”}
AWS Lambdaが呼び出した際に、ASGIリクエストをAWS環境へ仲介するハンドラー
handler = Mangum(app)
非常にシンプルですね。さて、通常であればここで `.venv` を作って `uv sync` をし、その中身を丸ごとZIPに固めるところですが……それだと無駄なファイルが混じってしまいます。
いよいよ、本記事のメインディッシュである `uv` を使った極限のアーカイブ化 に進みましょう！
—
4. 魔法のコマンド：`uv export` とビルド最適化
`uv` には、環境依存を排除し、指定したフォーマットで依存関係を出力・パックする強力な機能があります。
今回は、AWS Lambdaやコンテナのレイヤーに直接配置するための「純度100%の依存関係ディレクトリ」をクリーンに構築する手順を行います。
以下のコマンドを実行してください。
プロダクション（本番）環境に必要な依存関係のみを、指定したターゲットディレクトリにインストールする
uv pip install –target .lambda_artifact –no-dev –compile-bytecode
ここで、このコマンドのオプションの意味をプロの視点で詳しく解説します。これこそがサイズ最小化のキモです。
- `–target .lambda_artifact`: 通常の仮想環境ではなく、指定したディレクトリ（ここでは `.lambda_artifact`）に直接、依存パッケージのPythonファイルを平坦に展開します。Lambdaのデプロイ構造にそのまま合致させられます。
- `–no-dev`: 開発時のみ使用するテストツールやリントツールなどを完全に排除し、本番稼働に必要なパッケージだけを厳選します。
- `–compile-bytecode`: 事前にバイトコード（`.pyc`）をコンパイルして生成します。これにより、Lambdaなどのコンテナが起動した際のPythonインタプリタの初回パース時間を短縮し、コールドスタートをさらに高速化させます。
このコマンドを実行すると、数秒で `.lambda_artifact` ディレクトリが生成されます。
アプリケーションコードの同梱
パッケージの準備ができたら、先ほど作成したアプリケーション本体（`main.py`）を、そのディレクトリのルートにコピー（または配置）します。
アプリケーションコードを成果物ディレクトリに配置
cp main.py .lambda_artifact/
これで、`.lambda_artifact` の中には、「実行に必要なアプリケーションコード」と「厳選された最適化済みの依存ライブラリ」だけが存在する状態になりました。余計なメタデータやキャッシュは一切ありません。
—
5. デプロイ用アーカイブ（ZIP）の作成とサイズ比較
最後に、これをAWS Lambda等へアップロードするためのZIPアーカイブに固めましょう。
アーカイブディレクトリへ移動
cd .lambda_artifact
Lambdaに最適化されたZIPファイルをルートに作成
zip -r ../lambda_deployment.zip . > /dev/null
元のディレクトリに戻る
cd ..
さあ、ここで生成されたZIPファイルのサイズを確認してみましょう。
ファイルサイズを確認
ls -lh lambda_deployment.zip
どうでしょうか？ 従来の `pip` で仮想環境ごと固めた場合と比較して、数十％〜場合によっては半分以下のサイズにまでスリム化されているはずです。
この最適化がもたらす実務上の圧倒的なメリット
1. コールドスタートの劇的短縮:
AWS Lambdaは、デプロイパッケージの容量が大きければ大きいほど、ストレージからコードを読み込んでコンテナを初期化する（コールドスタート）に時間がかかります。サイズを最小化することで、APIの初回応答速度がミリ秒単位で改善されます。
2. CI/CDパイプラインの高速化:
ビルド・転送するデータ量が減るため、GitHub ActionsやGitLab CIなどのデプロイステップがスムーズになり、デプロイ待ちのストレスから解放されます。
3. セキュリティとクリーンネス:
不要なテストコードや脆弱性の温床になりうる開発用パッケージが本番環境に一切含まれないため、セキュリティポスチャ（安全性）が向上します。
—
おわりに
今回は、`uv` を用いたPython配布物のサイズ最小化と、デプロイ最適化の極意について解説しました。
「たかがパッケージマネージャー」と侮るなかれ。最新のツールチェーンの思想を正しく理解し、適切なオプション（`–target` や `–compile-bytecode`）を組み合わせることで、インフラコストの削減とユーザー体験の向上という、エンジニアにとって最高の結果を手にいれることができます。
「これをマスターすれば、毎日のコーディングだけでなく、デプロイの待ち時間やインフラの悩みまでもが劇的に軽くなりますよ」。
ぜひ、明日の開発からあなたのプロジェクトに `uv` の最適化フローを取り入れてみてください。その圧倒的なスピードと軽さに、きっと感動するはずです。
それでは、また次の技術の深淵でお会いしましょう！ Happy Coding!