Aan de slag

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.

2 MIN LEESTIJD

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, of pip install . bij een pyproject.toml.
  • Server — Django en Flask draaien op gunicorn, FastAPI op uvicorn. De server voegen we zelf aan de installatie toe.

Django

  • Herkend aan manage.py of django in de requirements.
  • Het startpunt wordt gelezen uit DJANGO_SETTINGS_MODULE in manage.py — <project>.wsgi:application.
  • Statische bestanden — python manage.py collectstatic draait 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 aan ALLOWED_HOSTS (bijvoorbeeld vanuit een variabele), en stel CSRF_TRUSTED_ORIGINS in 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:app

Wordt 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 $PORT

Databases

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.

Zie Diensten van een project.

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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support