Applicazioni Python: Django, Flask e FastAPI.
Come vengono riconosciuti e avviati i progetti Django, Flask e FastAPI, quale punto di ingresso cerchiamo, file statici, migrazioni ed esecuzione di Celery.
Un repository con requirements.txt, pyproject.toml, Pipfile o manage.py è un progetto Python. Riconosciamo Django, Flask e FastAPI e li avviamo con un server di produzione: non devi aggiungerlo tu.
Come viene costruito ed eseguito
- Python 3.11.
- Dipendenze:
pip install -r requirements.txt, oppurepip install .per unpyproject.toml. - Server: Django e Flask girano su gunicorn, FastAPI su uvicorn. Il server lo aggiungiamo noi all'installazione.
Django
- Viene riconosciuto da
manage.pyo dadjangonelle dipendenze. - Il punto di ingresso viene letto da
DJANGO_SETTINGS_MODULEinmanage.py:<project>.wsgi:application. - File statici: durante la build viene eseguito
python manage.py collectstatic. Servili dall'applicazione con WhiteNoise (aggiungilo al middleware) oppure dall'object storage. - Migrazioni: il comando di rilascio consigliato è
python manage.py migrate --noinput. Viene eseguito a ogni deploy prima che la nuova versione riceva visitatori; se fallisce, resta in esecuzione la versione attuale. - Aggiungi il tuo dominio e l'indirizzo
rivervo.appadALLOWED_HOSTS(ad esempio da una variabile) e impostaCSRF_TRUSTED_ORIGINSper i form in HTTPS.
Flask e FastAPI
Cerchiamo il file che crea l'applicazione (app.py, main.py, wsgi.py, application.py o server.py) e la variabile in cui è salvata:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appSe la tua applicazione viene creata altrove (una application factory, un pacchetto), imposta Impostazioni → Impostazioni di build → Comando di avvio, ad esempio:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTDatabase
Aggiungi PostgreSQL o MySQL al progetto e leggi DATABASE_URL, con dj-database-url per Django o direttamente con SQLAlchemy. Vedi Database.
Celery e altri worker
Aggiungi Valkey al progetto e configura Celery su REDIS_URL. Esegui il worker:
- nella scheda Processi come worker in background:
celery -A myproject worker -l info; - oppure come servizio worker in background separato, con risorse proprie;
- Celery beat come un altro worker in background (
celery -A myproject beat -l info), oppure un comando periodico come comando pianificato o attività pianificata.
Vedi Servizi di un progetto.
File che sopravvivono a un deploy
Ogni deploy parte da una copia pulita del tuo repository. I file che la tua applicazione scrive in /data vengono mantenuti tra un deploy e l'altro e salvati ogni giorno nel backup; tutto ciò che viene scritto altrove sparisce al deploy successivo. Per gli upload degli utenti usa l'object storage (per Django, django-storages con le variabili S3_*).
Altri progetti Python
Un progetto Python che non usa nessuno di questi framework ha bisogno di un suo Dockerfile nel repository; in quel caso facciamo la build con quello, così com'è.