Застосунки на Python: Django, Flask і FastAPI.
Як ми розпізнаємо й запускаємо проєкти на Django, Flask і FastAPI, яку точку входу шукаємо, статичні файли, міграції та запуск Celery.
Репозиторій із requirements.txt, pyproject.toml, Pipfile або manage.py — це проєкт на Python. Ми розпізнаємо Django, Flask і FastAPI та запускаємо їх на продакшн-сервері — додавати його самостійно не потрібно.
Як проєкт збирається й запускається
- Python 3.11.
- Залежності —
pip install -r requirements.txtабоpip install .дляpyproject.toml. - Сервер — Django і Flask працюють на gunicorn, FastAPI — на uvicorn. Сервер ми додаємо до встановлення самі.
Django
- Розпізнається за
manage.pyабоdjangoу залежностях. - Точка входу береться з
DJANGO_SETTINGS_MODULEуmanage.py—<project>.wsgi:application. - Статичні файли — під час збирання виконується
python manage.py collectstatic. Віддавайте їх із застосунку через WhiteNoise (додайте його в middleware) або з об’єктного сховища. - Міграції — рекомендована команда релізу —
python manage.py migrate --noinput. Вона виконується під час кожного розгортання, перш ніж нова версія почне приймати відвідувачів; якщо вона завершиться помилкою, поточна версія продовжить працювати. - Додайте свій домен і адресу
rivervo.appдоALLOWED_HOSTS(наприклад, зі змінної) і задайтеCSRF_TRUSTED_ORIGINSдля форм через HTTPS.
Flask і FastAPI
Ми шукаємо файл, який створює застосунок, — app.py, main.py, wsgi.py, application.py або server.py, — і змінну, у якій він зберігається:
# 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Якщо застосунок створюється деінде (фабрика застосунку, пакет), задайте Налаштування → Налаштування збирання → Команда запуску, наприклад:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTБази даних
Додайте до проєкту PostgreSQL або MySQL і читайте DATABASE_URL — через dj-database-url для Django або напряму в SQLAlchemy. Див. Бази даних.
Celery та інші фонові процеси
Додайте до проєкту Valkey і спрямуйте Celery на REDIS_URL. Запустіть обробник:
- на вкладці Процеси як фоновий процес —
celery -A myproject worker -l info; - або як окремий сервіс фоновий процес із власними ресурсами;
- Celery beat — ще одним фоновим процесом,
celery -A myproject beat -l info, а періодичну команду — як команду за розкладом або завдання за розкладом.
Див. Сервіси проєкту.
Файли, що переживають розгортання
Кожне розгортання починається зі свіжої копії вашого репозиторію. Файли, які застосунок записує в /data, зберігаються між розгортаннями, і щодня з них робиться резервна копія; усе, що записано деінде, зникне після наступного розгортання. Для завантажень користувачів використовуйте об’єктне сховище (для Django — django-storages зі змінними S3_*).
Інші проєкти на Python
Проєкту на Python, який не використовує жодного з цих фреймворків, потрібен власний Dockerfile у репозиторії; тоді ми збираємо проєкт за ним без змін.