Ứng dụng Python: Django, Flask và FastAPI.
Cách nhận diện và khởi chạy dự án Django, Flask và FastAPI, entry point chúng tôi tìm, tệp tĩnh, migration và chạy Celery.
Repository có requirements.txt, pyproject.toml, Pipfile hoặc manage.py là dự án Python. Chúng tôi nhận diện Django, Flask và FastAPI và khởi chạy chúng bằng server production — bạn không cần tự thêm.
Cách build và chạy
- Python 3.11.
- Dependency —
pip install -r requirements.txt, hoặcpip install .vớipyproject.toml. - Server — Django và Flask chạy trên gunicorn, FastAPI trên uvicorn. Chúng tôi tự thêm server vào bước cài đặt.
Django
- Nhận diện qua
manage.pyhoặcdjangotrong danh sách dependency. - Entry point được đọc từ
DJANGO_SETTINGS_MODULEtrongmanage.py—<project>.wsgi:application. - Tệp tĩnh —
python manage.py collectstaticchạy trong lúc build. Phục vụ chúng từ ứng dụng bằng WhiteNoise (thêm vào middleware) hoặc từ object storage. - Migration — lệnh release được đề xuất là
python manage.py migrate --noinput. Lệnh chạy ở mỗi lần deploy, trước khi phiên bản mới nhận lượt truy cập; nếu lỗi, phiên bản hiện tại vẫn tiếp tục chạy. - Thêm tên miền của bạn và địa chỉ
rivervo.appvàoALLOWED_HOSTS(ví dụ từ một biến), và đặtCSRF_TRUSTED_ORIGINScho các form HTTPS.
Flask và FastAPI
Chúng tôi tìm tệp tạo ứng dụng — app.py, main.py, wsgi.py, application.py hoặc server.py — và biến chứa ứng dụng:
# app.py
from flask import Flask
app = Flask(__name__) # → khởi chạy dưới dạng app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → khởi chạy dưới dạng main:appNếu ứng dụng được tạo ở nơi khác (application factory, một package), hãy đặt Cài đặt → Build settings → Start command, ví dụ:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORTCơ sở dữ liệu
Thêm PostgreSQL hoặc MySQL vào dự án và đọc DATABASE_URL — bằng dj-database-url với Django, hoặc trực tiếp bằng SQLAlchemy. Xem Cơ sở dữ liệu.
Celery và các worker khác
Thêm Valkey vào dự án và trỏ Celery tới REDIS_URL. Chạy worker:
- ở tab Processes dưới dạng background worker —
celery -A myproject worker -l info; - hoặc như một service background worker riêng có tài nguyên riêng;
- Celery beat là thêm một background worker —
celery -A myproject beat -l info— hoặc tác vụ định kỳ dưới dạng lệnh theo lịch hay tác vụ theo lịch.
Tệp được giữ qua các lần deploy
Mỗi lần deploy bắt đầu từ một bản sao mới của repository. Tệp ứng dụng ghi vào /data được giữ qua các lần deploy và sao lưu hằng ngày; mọi thứ ghi ở nơi khác sẽ mất sau lần deploy tiếp theo. Với tệp người dùng tải lên, hãy dùng object storage (với Django là django-storages cùng các biến S3_*).
Dự án Python khác
Dự án Python không dùng các framework này cần có Dockerfile riêng trong repository; khi đó chúng tôi build nguyên trạng theo tệp đó.