Contents
Docker環境でFastAPIアプリケーションをデプロイする際の基本的な考え方
Dockerコンテナ化は、FastAPIアプリケーションの本番環境構築において「一貫性・再現性・セキュリティ」の確保に不可欠です。特に複数環境での運用やチーム開発では、依存関係や設定をコンテナ単位で管理することで、バグの原因となる設定ミスを大幅に削減できます。本記事では、DockerとUvicornを組み合わせたデプロイ手順を、実務に即したベストプラクティスとともに解説します。
Dockerfileの作成方法（Pythonベースイメージ選定）
FastAPIアプリケーションのDocker化は、適切なベースイメージ選びから始まります。以下に選定基準と手順を示します。
最適なPythonベースイメージの選択基準
Pythonベースイメージの選定は性能・セキュリティ・運用コストに大きく影響するため、慎重に行う必要があります。
|
1 2 3 4 5 6 7 8 9 10 |
ここは表の前の説明文です。 | 項目 | 値 | 補足 | |------------|------------|----------------------------------| | **サイズ** | 100MB前後 | `python:3.10-slim`などの公式イメージ | | **機能** | 実行環境のみ | パッケージ管理ツール付きのフルイメージも選択可能 | | **使用シーン** | 本番環境・軽量化が求められる場合 | 開発環境や依存関係が多いプロジェクトではフルイメージを検討 | ここは表の後の説明文です。 |
- Pythonバージョン対応:
python:3.10-slimやpython:3.9-alpineなどの公式イメージを活用するのが安全です。アプリケーション要件に合わせて選択し、公式リポジトリから入手するようにします。
依存関係管理のベストプラクティス
依存関係の管理はDockerfileの肝であり、運用時の安定性とイメージサイズの最適化に直結します。
requirements.txtを作成し、必要なパッケージ一覧を明確化する。- マルチステージビルドで開発環境と実行環境を分離し、セキュリティリスクを低減。
- イメージサイズの削減に貢献するツール（例:
pip install --no-cache-dir）を使用する。
Dockerfileはプロジェクトの「肝」となります。最新バージョンで依存関係が破損しないように、リポジトリのバージョン制御も併せて行うことが重要です。
UvicornサーバーのDockerコンテナ起動手順
FastAPIアプリをUvicornで実行する際には、以下のような設定をDockerに組み込む必要があります。環境変数やポートマッピングなど、安定した運用のために重要な要素が含まれます。
環境変数による設定調整
Dockerコンテナの挙動は環境変数により柔軟に制御可能です。以下が主な設定項目です。
- ホストポートとコンテナポートのマッピング:
-p 8000:8000など、用途に応じた適切なマッピングを設定 - 非rootユーザーでの実行:
useradd -ms /bin/bash appuserなど、セキュリティ強化を考慮 - リソース制限の導入:
--memory=512m --cpus="1"などのパラメータで過剰消費を防ぐ
ポートマッピングの最適化
ポートマッピングは環境に応じて柔軟に対応する必要があります。
|
1 2 3 4 5 6 7 8 9 10 |
ここは表の前の説明文です。 | ケース | 推奨ポート | 補足 | |--------------------|------------------|----------------------------------| | **本番環境** | `80:80` | HTTPプロトコルでの外部アクセス | | **開発・テスト環境** | `8000:8000` | Uvicornデフォルトポート | | **ロードバランサー経由** | `443:443` | HTTPS通信を想定した設定 | ここは表の後の説明文です。 |
コンテナ内のUvicorn起動は、以下のようにDockerfileに記述します。
|
1 2 |
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"] |
環境変数の設定とセキュリティ対策
本番環境では、パスワードやAPIキーなどの機密情報は暗号化された形式で管理する必要があります。Docker Secretsなど、セキュアな手法を活用する必要があります。
暗号化された環境変数の管理方法
機密情報の取り扱いには特別な注意が必要です。
-
Docker Secrets:
docker secret createコマンドでセキュアに保存し、コンテナ起動時に自動的にマウント。
bash
docker secret create DB_PASSWORD mysecretpassword -
外部ツールとの連携: VaultやHashiCorpのSecrets Managerなどを使うと、複数コンテナ間での共有が可能です。
Docker Composeファイル内でのDocker Secrets使用例:
|
1 2 3 4 5 |
services: app: secrets: - DB_PASSWORD |
プロダクション環境向けの構成設計
プロダクション環境では以下の点に注意が必要です。
- 環境変数は
docker run --env-file .envなどのコマンドで指定（.gitignoreに含めない）。 - 機密情報を
.gitignoreや.dockerignoreに含めない。 - コンテナ間通信時は、ネットワークセキュリティグループの設定を厳格化。
特にデータベース接続情報などは、コンテナの起動時にだけ解読可能な形式で管理することが望ましいです。
Docker Composeによる複数サービス構成例
Docker Composeを使うと、FastAPIアプリだけでなく、データベースやキャッシュサーバーなどを同時に起動できます。以下の手順で設定を行います。
データベース連携の標準的な実装
DBとの接続は以下のようにdocker-compose.ymlに記述します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
services: db: image: postgres:15-alpine environment: POSTGRES_USER: user POSTGRES_PASSWORD_FILE: /run/secrets/db_password secrets: - db_password secrets: db_password: file: ./db_pass.txt |
ロードバランサーとの統合方法
ロードバランサーとの統合にはNginxやTraefikを活用します。
nginxやtraefikをサービスとして追加し、ルーティング設定を記述。- SSL証明書の自動発行機能を活用（例: Let's Encrypt）。
ロギング・メトリクス監視の導入方法
アプリケーションの安定性を維持するには、ロギングとモニタリングの仕組みが不可欠です。以下に具体的な実装手順を示します。
標準出力でのログハンドリング
FastAPIアプリは標準出力経由でログを吐くため、適切な設定を行う必要があります。
- FastAPIアプリは
uvicorn --log-configでログ設定ファイルを使う。 - ログレベル（INFO/DEBUG等）は環境に応じて柔軟に調整。
外部モニタリングツールとの連携
以下のような外部サービスと連携することで、監視体制を整えることができます。
- Prometheus: コンテナのメトリクスを収集して可視化。
- Grafana: 監視ダッシュボード作成に最適。
- ELKスタック（Elasticsearch, Logstash, Kibana）: ログデータの中央集約と分析。
ロギングの永続化には、
/var/log/app.logなどに書き出し、Docker Composeでボリュームをマウントしておくと良いです。
実際のプロジェクトで本記事の手順を試してみましょう
上記の手順をもとに、ローカル環境からステージング環境、最終的に本番環境へと段階的にデプロイできます。初期設定でトラブルが発生した場合は、コメント欄に具体的なエラーメッセージやコンテナログを添えてご相談ください。
Docker Secretsの使用手順（補足）
Docker Secretsの実装には以下のステップが必要です。
-
Secretの作成:
bash
docker secret create DB_PASSWORD mysecretpassword -
Docker Composeでの利用:
yaml
services:
db:
image: postgres
secrets:
- DB_PASSWORD
secrets:
DB_PASSWORD:
file: ./db_password.txt -
コンテナ内での参照:
コンテナ内で/run/secrets/DB_PASSWORDにアクセスすることで、暗号化されたパスワードが読み込めます。
このようにDocker Secretsを使うことで、機密情報の漏洩リスクを大幅に軽減できます。