Aplikacje Python: Django, Flask i FastAPI.
Jak rozpoznajemy i uruchamiamy projekty Django, Flask i FastAPI, jakiego punktu wejścia szukamy, pliki statyczne, migracje i uruchamianie Celery.
Repozytorium z requirements.txt, pyproject.toml, Pipfile lub manage.py to projekt Python. Rozpoznajemy Django, Flask i FastAPI i uruchamiamy je na serwerze produkcyjnym — nie musisz go dodawać sam.
Jak projekt jest budowany i uruchamiany
- Python 3.11.
- Zależności —
pip install -r requirements.txtalbopip install .dlapyproject.toml. - Serwer — Django i Flask działają na gunicorn, FastAPI na uvicorn. Serwer dodajemy do instalacji sami.
Django
- Rozpoznajemy po
manage.pylubdjangow zależnościach. - Punkt wejścia odczytujemy z
DJANGO_SETTINGS_MODULEwmanage.py—<project>.wsgi:application. - Pliki statyczne —
python manage.py collectstaticuruchamia się podczas budowania. Serwuj je z aplikacji przez WhiteNoise (dodaj go do middleware) albo z magazynu obiektów. - Migracje — zalecane polecenie wydania to
python manage.py migrate --noinput. Uruchamia się przy każdym wdrożeniu, zanim nowa wersja zacznie przyjmować odwiedzających; jeśli się nie powiedzie, działa dalej bieżąca wersja. - Dodaj swoją domenę i adres
rivervo.appdoALLOWED_HOSTS(na przykład ze zmiennej) i ustawCSRF_TRUSTED_ORIGINSdla formularzy przez HTTPS.
Flask i FastAPI
Szukamy pliku, który tworzy aplikację — app.py, main.py, wsgi.py, application.py lub server.py — i zmiennej, w której jest zapisana:
# app.py
from flask import Flask
app = Flask(__name__) # → started as app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → started as main:appJeśli aplikacja powstaje gdzie indziej (fabryka aplikacji, pakiet), ustaw Ustawienia → Ustawienia budowania → Polecenie uruchomienia, na przykład:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTBazy danych
Dodaj do projektu PostgreSQL lub MySQL i czytaj DATABASE_URL — w Django przez dj-database-url, albo bezpośrednio przez SQLAlchemy. Zobacz Bazy danych.
Celery i inne workery
Dodaj do projektu Valkey i skieruj Celery na REDIS_URL. Uruchom worker:
- na karcie Procesy jako worker w tle —
celery -A myproject worker -l info; - albo jako osobną usługę typu worker w tle z własnymi zasobami;
- Celery beat jako kolejny worker w tle —
celery -A myproject beat -l info— albo okresowe polecenie jako polecenie harmonogramu lub zadanie harmonogramu.
Zobacz Usługi projektu.
Pliki, które przetrwają wdrożenie
Każde wdrożenie zaczyna się od świeżej kopii repozytorium. Pliki, które aplikacja zapisuje w /data, zostają między wdrożeniami i codziennie trafiają do kopii zapasowej; wszystko zapisane gdzie indziej znika po następnym wdrożeniu. Na pliki wgrywane przez użytkowników używaj magazynu obiektów (w Django — django-storages ze zmiennymi S3_*).
Inne projekty Python
Projekt Python, który nie korzysta z żadnego z tych frameworków, potrzebuje własnego pliku Dockerfile w repozytorium; budujemy go wtedy dokładnie według niego.