Python-applicaties: Django, Flask en FastAPI.
Hoe Django-, Flask- en FastAPI-projecten worden herkend en gestart, welk startpunt we zoeken, statische bestanden, migraties en Celery draaien.
Een repository met requirements.txt, pyproject.toml, Pipfile of manage.py is een Python-project. We herkennen Django, Flask en FastAPI en starten ze met een productieserver — die hoef je niet zelf toe te voegen.
Zo wordt het gebouwd en gestart
- Python 3.11.
- Dependencies —
pip install -r requirements.txt, ofpip install .bij eenpyproject.toml. - Server — Django en Flask draaien op gunicorn, FastAPI op uvicorn. De server voegen we zelf aan de installatie toe.
Django
- Herkend aan
manage.pyofdjangoin de requirements. - Het startpunt wordt gelezen uit
DJANGO_SETTINGS_MODULEinmanage.py—<project>.wsgi:application. - Statische bestanden —
python manage.py collectstaticdraait tijdens de build. Serveer ze vanuit de applicatie met WhiteNoise (voeg het toe aan je middleware) of vanuit objectopslag. - Migraties — de aanbevolen releaseopdracht is
python manage.py migrate --noinput. Die draait bij elke deploy voordat de nieuwe versie bezoekers krijgt; mislukt hij, dan blijft de huidige versie draaien. - Voeg je domein en het
rivervo.app-adres toe aanALLOWED_HOSTS(bijvoorbeeld vanuit een variabele), en stelCSRF_TRUSTED_ORIGINSin voor formulieren over HTTPS.
Flask en FastAPI
We zoeken het bestand dat de applicatie aanmaakt — app.py, main.py, wsgi.py, application.py of server.py — en de variabele waarin die is opgeslagen:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appWordt je applicatie ergens anders aangemaakt (een application factory, een package), stel dan Instellingen → Build-instellingen → Startopdracht in, bijvoorbeeld:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTDatabases
Voeg PostgreSQL of MySQL aan het project toe en lees DATABASE_URL — met dj-database-url voor Django, of rechtstreeks met SQLAlchemy. Zie Databases.
Celery en andere workers
Voeg Valkey aan het project toe en laat Celery naar REDIS_URL verwijzen. De worker draai je:
- op het tabblad Processen als achtergrondworker —
celery -A myproject worker -l info; - of als aparte dienst van het type achtergrondworker met eigen resources;
- Celery beat als nog een achtergrondworker —
celery -A myproject beat -l info— of een periodieke opdracht als geplande opdracht of geplande taak.
Bestanden die een deploy overleven
Elke deploy begint met een verse kopie van je repository. Bestanden die je applicatie naar /data schrijft, blijven tussen deploys bewaard en worden dagelijks geback-upt; alles wat ergens anders wordt weggeschreven, is na de volgende deploy weg. Gebruik voor uploads van gebruikers objectopslag (voor Django django-storages met de S3_*-variabelen).
Andere Python-projecten
Een Python-project dat geen van deze frameworks gebruikt, heeft een eigen Dockerfile in de repository nodig; daarmee bouwen we het dan zoals het is.