Aplicații Python: Django, Flask și FastAPI.
Cum sunt detectate și pornite proiectele Django, Flask și FastAPI, ce punct de intrare căutăm, fișierele statice, migrările și rularea Celery.
Un repository cu requirements.txt, pyproject.toml, Pipfile sau manage.py este un proiect Python. Recunoaștem Django, Flask și FastAPI și le pornim cu un server de producție — nu trebuie să adaugi tu unul.
Cum se construiește și cum rulează
- Python 3.11.
- Dependențe —
pip install -r requirements.txtsaupip install .pentru unpyproject.toml. - Server — Django și Flask rulează pe gunicorn, FastAPI pe uvicorn. Adăugăm noi serverul la instalare.
Django
- Recunoscut după
manage.pysau dupădjangoîn dependențe. - Punctul de intrare este citit din
DJANGO_SETTINGS_MODULEdinmanage.py—<project>.wsgi:application. - Fișiere statice —
python manage.py collectstaticrulează în timpul build-ului. Servește-le din aplicație cu WhiteNoise (adaugă-l în middleware) sau din stocarea de obiecte. - Migrări — comanda de lansare recomandată este
python manage.py migrate --noinput. Rulează la fiecare publicare, înainte ca noua versiune să primească vizitatori; dacă eșuează, versiunea curentă continuă să ruleze. - Adaugă domeniul tău și adresa
rivervo.appînALLOWED_HOSTS(de exemplu dintr-o variabilă) și seteazăCSRF_TRUSTED_ORIGINSpentru formularele prin HTTPS.
Flask și FastAPI
Căutăm fișierul care creează aplicația — app.py, main.py, wsgi.py, application.py sau server.py — și variabila în care este păstrată:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appDacă aplicația ta este creată în altă parte (un application factory, un pachet), setează Setări → Setări de build → Comandă de pornire, de exemplu:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTBaze de date
Adaugă PostgreSQL sau MySQL în proiect și citește DATABASE_URL — cu dj-database-url pentru Django sau direct cu SQLAlchemy. Vezi Baze de date.
Celery și alți workeri
Adaugă Valkey în proiect și îndreaptă Celery spre REDIS_URL. Rulează workerul:
- în fila Procese, ca worker de fundal —
celery -A myproject worker -l info; - sau ca serviciu separat de tip worker de fundal, cu resurse proprii;
- Celery beat ca încă un worker de fundal —
celery -A myproject beat -l info— sau o comandă periodică sub formă de comandă programată ori sarcină programată.
Vezi Serviciile unui proiect.
Fișiere care rămân după o publicare
Fiecare publicare pornește de la o copie nouă a repository-ului. Fișierele pe care aplicația le scrie în /data se păstrează între publicări și au backup zilnic; orice e scris în altă parte dispare la următoarea publicare. Pentru fișierele încărcate de utilizatori, folosește stocarea de obiecte (pentru Django, django-storages cu variabilele S3_*).
Alte proiecte Python
Un proiect Python care nu folosește niciunul dintre aceste frameworkuri are nevoie de propriul Dockerfile în repository; atunci construim cu el, exact așa cum este.