立即开始

Python 应用:Django、Flask 和 FastAPI。

Django、Flask 和 FastAPI 项目的识别和启动方式、我们查找的入口点、静态文件、迁移以及 Celery 的运行。

1 分钟阅读

包含 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;我们会直接使用它进行构建。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持