パッケージ化してリリース — 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()

作成.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 デプロイ

  1. アクセスrailway.app、GitHub でログイン
  2. New Project → Deploy from GitHub repo → fastapi-blog を選択
  3. Railway は Procfile を自動検出します
  4. Variables で環境変数を設定します
  5. Deploy をクリック

環境変数の設定

変数名值説明
SECRET_KEYランダムに生成された長い文字列JWT 署名キー
DATABASE_URLRailway によって注入されます本番データベース

デプロイ成功後にリンクを取得し、/docs にアクセスすると Swagger ドキュメントを確認でき、/admin にアクセスすると管理画面に入れます。


フレームワーク比較

機能FastAPIDjangoFlask
ORMSQLAlchemyDjango ORM(組み込み)Flask-SQLAlchemy
データ検証PydanticDjango FormsFlask-WTF
ルーティング構成APIRouterurls.pyBlueprint
ユーザー認証JWT + OAuth2Session Auth(組み込み)Flask-Login(Session)
データベースマイグレーションAlembicmakemigrations / migrateFlask-Migrate
管理画面sqladminDjango AdminFlask-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 をインストール
その他の拡張