パッケージ化してリリース — Railway にデプロイ
この章では、FastAPI の本番環境設定を学び、Railway を使ってブログを本番公開します。
本番環境の設定管理
(venv) $ pip install pydantic-settings python-dotenv
実例
# ファイルパス: config.py
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
"""アプリ設定(.env ファイルから自動読み込み)"""
app_name: str = "サンプル ブログ"
debug: bool = False
secret_key: str = "dev-secret-key-change-me"
database_url: str = "sqlite:///./blog.db"
access_token_expire_minutes: int = 60 * 24 * 7 # 7 日間
class Config:
env_file = ".env" # 環境変数ファイルを指定
settings = Settings()
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
"""アプリ設定(.env ファイルから自動読み込み)"""
app_name: str = "サンプル ブログ"
debug: bool = False
secret_key: str = "dev-secret-key-change-me"
database_url: str = "sqlite:///./blog.db"
access_token_expire_minutes: int = 60 * 24 * 7 # 7 日間
class Config:
env_file = ".env" # 環境変数ファイルを指定
settings = Settings()
作成.envファイル:
SECRET_KEY=a1b2c3d4...your-real-secret-key DATABASE_URL=sqlite:///./blog.db DEBUG=False
依存関係ファイルの生成
(venv) $ pip freeze > requirements.txt
コア依存関係が含まれていることを確認してください: fastapi、uvicorn、sqlalchemy、jinja2、alembic、passlib、python-jose、python-multipart、sqladmin、pydantic-settings。
Procfile と起動コマンドの設定
FastAPI は ASGI サーバーを使用します。Flask/Django の WSGI とは異なります:
web: uvicorn main:app --host 0.0.0.0 --port $PORT
複数 worker が必要な場合(本番環境では推奨):
web: gunicorn -k uvicorn.workers.UvicornWorker -w 4 main:app
WSGI vs ASGI:Django/Flask は Gunicorn(WSGI サーバー)を使用し、FastAPI は Uvicorn(ASGI サーバー)を使用します。Gunicorn 自体は WSGI ですが、以下の方法で
uvicorn.workers.UvicornWorkerASGI アプリを実行できます。
GitHub へプッシュ
$ git init $ echo "venv/" > .gitignore $ echo "__pycache__/" >> .gitignore $ echo "*.pyc" >> .gitignore $ echo ".env" >> .gitignore $ git add . $ git commit -m "初始化 FastAPI 博客项目" $ git branch -M main $ git remote add origin https://github.com/你的用户名/fastapi-blog.git $ git push -u origin main
Railway デプロイ
- アクセスrailway.app、GitHub でログイン
- New Project → Deploy from GitHub repo → fastapi-blog を選択
- Railway は Procfile を自動検出します
- Variables で環境変数を設定します
- Deploy をクリック
環境変数の設定
| 変数名 | 值 | 説明 |
|---|---|---|
| SECRET_KEY | ランダムに生成された長い文字列 | JWT 署名キー |
| DATABASE_URL | Railway によって注入されます | 本番データベース |
デプロイ成功後にリンクを取得し、/docs にアクセスすると Swagger ドキュメントを確認でき、/admin にアクセスすると管理画面に入れます。
フレームワーク比較
| 機能 | FastAPI | Django | Flask |
|---|---|---|---|
| ORM | SQLAlchemy | Django ORM(組み込み) | Flask-SQLAlchemy |
| データ検証 | Pydantic | Django Forms | Flask-WTF |
| ルーティング構成 | APIRouter | urls.py | Blueprint |
| ユーザー認証 | JWT + OAuth2 | Session Auth(組み込み) | Flask-Login(Session) |
| データベースマイグレーション | Alembic | makemigrations / migrate | Flask-Migrate |
| 管理画面 | sqladmin | Django Admin | Flask-Admin |
| API ドキュメント | /docs(自動) | drf-spectacular が必要 | Flasgger が必要 |
| サーバー | Uvicorn(ASGI) | Gunicorn(WSGI) | Gunicorn(WSGI) |
次の学習ステップ
| 学習の方向性 | 向いている人 | 推奨される開始点 |
|---|---|---|
| 非同期 SQLAlchemy | より高い並行処理性能が必要 | 同期 Session を AsyncSession に切り替える |
| FastAPI + Vue3/React のフロントエンド/バックエンド分離 | SPA + API アーキテクチャ | Jinja2 テンプレートを Vue3/React に置き換え、FastAPI は純粋に API バックエンドとして使用 |
| WebSocket | リアルタイムプッシュ(チャット、通知)が必要 | FastAPI は WebSocket をネイティブサポート:@app.websocket() |
| PostgreSQL | 本番レベルのデータベース | DATABASE_URL を置き換え、asyncpg または psycopg2 をインストール |