Python-apps: Django, Flask en FastAPI

Laatst gecontroleerd

Een Python-site draait je eigen Python-webapp: Django, Flask, FastAPI, Starlette of iets anders dat HTTP op een poort serveert. Wij installeren de dependencies in een eigen virtuele omgeving, starten de app als bewaakte service en zetten nginx ervoor. Dit artikel beschrijft wat je app moet doen, en wat wij ervoor doen.

Hoe het draait

  • Python 3.12, 3.13, 3.14 en 3.15, te wisselen op de sitepagina onder Configure → Python version: kies een versie onder Run on en klik op Switch. Elke versie draait altijd de nieuwste release (de lijst toont die exact, zoals Python 3.14.10); verschijnt er een nieuwere patch, dan herstart je app er dezelfde nacht op.
  • Elke versie heeft een eigen virtuele omgeving, en die blijft bewaard. Bij het wisselen installeren we eerst je dependencies in de omgeving van de nieuwe versie en herstarten we pas daarna je app erop, meestal binnen een paar minuten; tot dan blijft je site antwoorden op de oude versie. Mislukt de installatie, dan blijft je app op de versie die hij had. Terugwisselen naar een versie die je eerder gebruikte gaat snel: de omgeving staat er nog.
  • Je app wordt door de servicemanager van het systeem gestart als eigen gebruiker, herstart als hij crasht, en krijgt een geheugenlimiet die bij je abonnement past.
  • nginx luistert aan de buitenkant. Alles in de map public/ van je project wordt direct van schijf geserveerd; elk ander verzoek gaat naar je app.
  • TLS, je domein, back-ups en monitoring werken zoals bij elke andere site.

Dependencies

Bij elke deploy, elke versiewissel en elke start controleren we je dependencies en installeren we ze met pip in de virtuele omgeving van de site als ze zijn veranderd (een ongewijzigde lijst wordt niet opnieuw geïnstalleerd, dus herstarten blijft snel):

  • uv.lock (met zijn pyproject.toml) in de hoofdmap van je project: uv installeert precies de vastgelegde set (uv sync --frozen --no-dev): ontwikkel-dependencies blijven weg en er wordt niets stiekem bijgewerkt. Je project zelf wordt ook geïnstalleerd als zijn pyproject.toml een build-systeem opgeeft;
  • anders requirements.txt: pip install -r requirements.txt;
  • anders pyproject.toml: de pakketten onder [project] dependencies. Je project zelf wordt niet als pakket gebouwd, dus een app die alleen een map met modules is werkt ook.

Pin je versies (een gecommitte uv.lock, of Django==5.2.* in requirements.txt), zodat een deploy installeert wat je hebt getest. Een uv.lock die niet meer bij pyproject.toml past laat de deploy mislukken: draai uv lock en push opnieuw. Pakketten met gecompileerde delen installeren vanuit wheels; heeft er een nog geen wheel voor jouw Python-versie, wissel dan naar de versie ervoor.

Deployen

Koppel een repository op het tabblad Deploys van de site onder Deploy from Git (zie Deploy from Git). Bij elke deploy kopiëren we je project naar je site, installeren we de dependencies zoals hierboven, herstarten we je app en wachten we tot hij op zijn poort antwoordt. Een kapot startcommando of een ontbrekende dependency laat de deploy mislukken, en het deploylog zegt waarom. Install & restart op het tabblad Deploys doet dezelfde installatie en herstart op de code die al op je site staat.

Django-migraties draaien we voor je. Heeft je project een manage.py, dan draait elke deploy python manage.py migrate --noinput met de omgevingsvariabelen van je site, nadat de nieuwe dependencies zijn geïnstalleerd en voordat je app op de nieuwe code herstart. We maken eerst een back-up van de sitedatabase (de laatste vijf kopieën blijven bewaard). Een mislukte migratie stopt de deploy, je app blijft draaien zoals hij was, en het deploylog toont de fout. De schakelaar voor databasemigraties onder Build steps op het tabblad Deploys zet dit uit. Met release-goedkeuring aan wachten de migraties met de release op de goedkeuring. Andere frameworks: draai de jouwe vanuit het startcommando (alembic upgrade head && uvicorn main:app --host 127.0.0.1 --port $PORT) of via SSH.

Het startcommando

Laat Start command leeg en we leiden het af uit je project, in deze volgorde:

  1. een Procfile met een web:-regel;
  2. Django: manage.py plus een <project>/wsgi.py, met gunicorn geïnstalleerd — gunicorn <project>.wsgi;
  3. FastAPI: main.py die FastAPI(...) aanmaakt, met uvicorn geïnstalleerd — uvicorn main:app;
  4. Flask: app.py die Flask(...) aanmaakt, met gunicorn geïnstalleerd — gunicorn app:app;
  5. python main.py of python app.py;
  6. anders een tijdelijke pagina, tot je deployt.

Heeft je app iets anders nodig, zet het dan op de sitepagina onder Configure → Python version → Start command en klik op Save. Laat het leeg om terug te gaan naar de detectie.

Framework Toevoegen aan je dependencies Startcommando
Django gunicorn gunicorn mysite.wsgi --bind 127.0.0.1:$PORT
Flask gunicorn gunicorn app:app --bind 127.0.0.1:$PORT
FastAPI uvicorn uvicorn main:app --host 127.0.0.1 --port $PORT
Iets anders python main.py (dat zelf PORT leest)

Het commando draait vanuit de hoofdmap van je project, met de virtuele omgeving van je site vooraan op het PATH, dus python, gunicorn en uvicorn zijn de versies die jij hebt geïnstalleerd. Aanhalingstekens zijn niet toegestaan.

De omgevingsvariabele PORT

Je app moet luisteren op de poort in de omgevingsvariabele PORT, op 127.0.0.1: nginx verbindt er lokaal mee. gunicorn en uvicorn krijgen hem zoals hierboven; in gewoon Python lees je os.environ["PORT"]. We zetten ook PYTHONUNBUFFERED=1, zodat wat je app print meteen in de logs staat.

Voeg je eigen variabelen (geheime sleutels, API-sleutels) toe onder Configure → Environment variables; je app wordt herstart zodat hij ze oppikt. PORT is altijd van ons. Heeft je site een beheerde database, dan staan de DB_*-variabelen al klaar: lees ze met os.environ["DB_HOST"] en verwanten.

Achter een proxy

Verzoeken komen via gewoon HTTP van nginx bij je app, met de echte gegevens in headers: X-Forwarded-Proto (https), X-Forwarded-For en X-Forwarded-Host. Laat je framework ze vertrouwen, zodat het https://-links maakt: in Django SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https") en je domein in ALLOWED_HOSTS; in Flask werkzeugs ProxyFix; met uvicorn --proxy-headers.

Als er iets misgaat

Het tabblad Logs toont de eigen uitvoer van je app, dus een mislukte start zie je snel. Veelvoorkomende oorzaken: de app luistert op een vaste poort in plaats van PORT, gunicorn of uvicorn ontbreekt in je dependencies, of een pakket heeft geen build voor de Python-versie waarnaar je wisselde. Herstel, push, deploy opnieuw.

Gerelateerd

Kom je er niet uit? Neem contact op met support — antwoord binnen één werkdag.