Applications Python : Django, Flask et FastAPI.
Comment les projets Django, Flask et FastAPI sont détectés et démarrés, quel point d'entrée nous recherchons, les fichiers statiques, les migrations et l'exécution de Celery.
Un dépôt qui contient requirements.txt, pyproject.toml, Pipfile ou manage.py est un projet Python. Nous reconnaissons Django, Flask et FastAPI et les démarrons avec un serveur de production : vous n'avez pas à en ajouter un vous-même.
Build et exécution
- Python 3.11.
- Dépendances —
pip install -r requirements.txt, oupip install .pour unpyproject.toml. - Serveur — Django et Flask tournent sur gunicorn, FastAPI sur uvicorn. Nous ajoutons nous-mêmes le serveur à l'installation.
Django
- Reconnu grâce à
manage.pyou àdjangodans les dépendances. - Le point d'entrée est lu dans
DJANGO_SETTINGS_MODULEdemanage.py—<project>.wsgi:application. - Fichiers statiques —
python manage.py collectstatics'exécute pendant le build. Servez-les depuis l'application avec WhiteNoise (ajoutez-le à votre middleware) ou depuis le stockage objet. - Migrations — la commande de publication recommandée est
python manage.py migrate --noinput. Elle s'exécute à chaque déploiement, avant que la nouvelle version reçoive des visiteurs ; si elle échoue, la version actuelle continue de tourner. - Ajoutez votre domaine et l'adresse
rivervo.appàALLOWED_HOSTS(par exemple depuis une variable), et définissezCSRF_TRUSTED_ORIGINSpour les formulaires en HTTPS.
Flask et FastAPI
Nous cherchons le fichier qui crée l'application — app.py, main.py, wsgi.py, application.py ou server.py — et la variable dans laquelle elle est stockée :
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appSi votre application est créée ailleurs (une factory d'application, un package), renseignez Paramètres → Paramètres de build → Commande de démarrage, par exemple :
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTBases de données
Ajoutez PostgreSQL ou MySQL au projet et lisez DATABASE_URL — avec dj-database-url pour Django, ou directement avec SQLAlchemy. Voir Bases de données.
Celery et autres workers
Ajoutez Valkey au projet et faites pointer Celery vers REDIS_URL. Lancez le worker :
- dans l'onglet Processus, comme worker en arrière-plan —
celery -A myproject worker -l info; - ou comme service worker en arrière-plan séparé, avec ses propres ressources ;
- Celery beat comme worker en arrière-plan supplémentaire —
celery -A myproject beat -l info— ou une commande périodique comme commande planifiée ou tâche planifiée.
Voir Services d'un projet.
Fichiers conservés d'un déploiement à l'autre
Chaque déploiement part d'une copie neuve de votre dépôt. Les fichiers que votre application écrit dans /data sont conservés entre les déploiements et sauvegardés chaque jour ; tout ce qui est écrit ailleurs disparaît au déploiement suivant. Pour les fichiers envoyés par les utilisateurs, utilisez le stockage objet (pour Django, django-storages avec les variables S3_*).
Autres projets Python
Un projet Python qui n'utilise aucun de ces frameworks a besoin de son propre Dockerfile dans le dépôt ; nous construisons alors l'application avec ce fichier tel quel.