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,或对pyproject.toml执行pip install .。 - 服务器——Django 和 Flask 运行在 gunicorn 上,FastAPI 运行在 uvicorn 上。服务器由我们自动加入安装。
Django
- 通过
manage.py或依赖中的django识别。 - 入口点从
manage.py中的DJANGO_SETTINGS_MODULE读取——<project>.wsgi:application。 - 静态文件——构建期间执行
python manage.py collectstatic。可通过 WhiteNoise(添加到中间件)由应用提供,或使用对象存储。 - 迁移——推荐的 发布命令 是
python manage.py migrate --noinput。它在每次部署时、新版本接收访问之前运行;如果失败,当前版本会继续运行。 - 将您的域名和
rivervo.app地址添加到ALLOWED_HOSTS(例如通过变量),并为 HTTPS 表单设置CSRF_TRUSTED_ORIGINS。
Flask 和 FastAPI
我们会查找创建应用的文件——app.py、main.py、wsgi.py、application.py 或 server.py——以及保存应用的变量:
# app.py
from flask import Flask
app = Flask(__name__) # → 以 app:app 启动# main.py
from fastapi import FastAPI
app = FastAPI() # → 以 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——Django 可使用 dj-database-url,也可直接通过 SQLAlchemy 读取。请参阅数据库。
Celery 及其他 Worker
向项目添加 Valkey,并将 Celery 指向 REDIS_URL。运行 Worker 的方式:
- 在 进程 标签页中作为后台 Worker——
celery -A myproject worker -l info; - 或作为拥有独立资源的单独 后台 Worker 服务;
- Celery beat 可作为另一个后台 Worker 运行——
celery -A myproject beat -l info——周期性命令也可作为 定时命令 或 定时作业 运行。
请参阅项目服务。
部署后保留的文件
每次部署都从仓库的全新副本开始。应用写入 /data 的文件会在部署之间保留并每日备份;写入其他位置的内容在下一次部署后会丢失。对于用户上传的文件,请使用对象存储(Django 可使用 django-storages 配合 S3_* 变量)。
其他 Python 项目
不使用上述框架的 Python 项目,需要在仓库中提供自己的 Dockerfile;我们会直接使用它进行构建。