Почати

Застосунки на Python: Django, Flask і FastAPI.

Як ми розпізнаємо й запускаємо проєкти на Django, Flask і FastAPI, яку точку входу шукаємо, статичні файли, міграції та запуск Celery.

2 ХВ ЧИТАННЯ

Репозиторій із 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 у репозиторії; тоді ми збираємо проєкт за ним без змін.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку