Pythonアプリケーション:Django、Flask、FastAPI。
Django、Flask、FastAPIのプロジェクトの判別と起動の仕組み、探すエントリーポイント、静的ファイル、マイグレーション、Celeryの実行について説明します。
requirements.txt、pyproject.toml、Pipfile、manage.pyのいずれかがあるリポジトリはPythonプロジェクトとして扱われます。Django、Flask、FastAPIを判別し、本番用のサーバーで起動します。サーバーをご自身で追加する必要はありません。
ビルドと実行の仕組み
- Python 3.11。
- 依存関係:
pip install -r requirements.txt、またはpyproject.tomlの場合はpip install .。 - サーバー:DjangoとFlaskはgunicorn、FastAPIはuvicornで動作します。サーバーはこちらでインストールに追加します。
Django
manage.py、または依存関係のdjangoで判別されます。- エントリーポイントは
manage.pyのDJANGO_SETTINGS_MODULEから読み取ります:<project>.wsgi:application。 - 静的ファイル:ビルド中に
python manage.py collectstaticが実行されます。WhiteNoise(ミドルウェアに追加)でアプリから配信するか、オブジェクトストレージから配信してください。 - マイグレーション:推奨のリリースコマンドは
python manage.py migrate --noinputです。デプロイのたびに、新しいバージョンが訪問者を受け付ける前に実行されます。失敗した場合は、現在のバージョンが動作を続けます。 - ドメインと
rivervo.appのアドレスをALLOWED_HOSTSに追加し(たとえば変数から)、HTTPSのフォーム用にCSRF_TRUSTED_ORIGINSを設定してください。
FlaskとFastAPI
アプリを作成しているファイル(app.py、main.py、wsgi.py、application.py、server.py)と、アプリが格納されている変数を探します。
# app.py
from flask import Flask
app = Flask(__name__) # → app:app として起動# main.py
from fastapi import FastAPI
app = FastAPI() # → main:app として起動アプリが別の場所(アプリケーションファクトリー、パッケージ)で作成されている場合は、設定 → ビルド設定 → 起動コマンドを設定します。例:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTデータベース
プロジェクトにPostgreSQLまたはMySQLを追加し、DATABASE_URLを読み込みます。Djangoならdj-database-urlで、SQLAlchemyなら直接読み込めます。詳しくはデータベースをご覧ください。
Celeryとその他のワーカー
プロジェクトにValkeyを追加し、Celeryの接続先をREDIS_URLにします。ワーカーの実行方法:
- プロセスタブでバックグラウンドワーカーとして:
celery -A myproject worker -l info - または、独自のリソースを持つ別のバックグラウンドワーカーサービスとして
- Celery beatはもう1つのバックグラウンドワーカーとして(
celery -A myproject beat -l info)、または定期的なコマンドをスケジュールコマンドやスケジュールジョブとして
プロジェクトのサービスをご覧ください。
デプロイ後も残るファイル
各デプロイはリポジトリの新しいコピーから始まります。アプリが/dataに書き込んだファイルはデプロイ後も残り、毎日バックアップされます。それ以外の場所に書き込んだものは、次のデプロイで消えます。ユーザーのアップロードファイルにはオブジェクトストレージをご利用ください(DjangoならS3_*変数とともにdjango-storagesを使います)。
その他のPythonプロジェクト
これらのフレームワークを使わないPythonプロジェクトでは、リポジトリに独自のDockerfileが必要です。その場合、そのDockerfileをそのまま使ってビルドします。