แอปพลิเคชัน Python: Django, Flask และ FastAPI
วิธีที่ระบบตรวจจับและเริ่มโปรเจกต์ Django, Flask และ FastAPI, entry point ที่เราค้นหา, ไฟล์สแตติก, migration และการรัน Celery
รีโพสิทอรีที่มี requirements.txt, pyproject.toml, Pipfile หรือ manage.py คือโปรเจกต์ Python เรารู้จัก Django, Flask และ FastAPI และเริ่มทำงานด้วยเซิร์ฟเวอร์สำหรับ production โดยคุณไม่ต้องเพิ่มเอง
การ build และการรัน
- Python 3.11
- Dependencies —
pip install -r requirements.txtหรือpip install .สำหรับpyproject.toml - เซิร์ฟเวอร์ — Django และ Flask รันบน gunicorn, FastAPI รันบน uvicorn เราเพิ่มเซิร์ฟเวอร์ในการติดตั้งให้เอง
Django
- ตรวจจับจาก
manage.pyหรือdjangoใน requirements - entry point อ่านจาก
DJANGO_SETTINGS_MODULEในmanage.pyคือ<project>.wsgi:application - ไฟล์สแตติก —
python manage.py collectstaticรันระหว่าง build ให้บริการไฟล์จากแอปพลิเคชันด้วย WhiteNoise (เพิ่มลงใน middleware) หรือจาก object storage - Migration — คำสั่ง release ที่แนะนำคือ
python manage.py migrate --noinputซึ่งรันในทุกการ deploy ก่อนที่เวอร์ชันใหม่จะเริ่มรับผู้เข้าชม หากล้มเหลว เวอร์ชันปัจจุบันจะยังทำงานต่อไป - เพิ่มโดเมนของคุณและที่อยู่
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__) # → เริ่มเป็น app:app# main.py
from fastapi import FastAPI
app = FastAPI() # → เริ่มเป็น main:appหากแอปพลิเคชันถูกสร้างที่อื่น (application factory หรือ package) ให้ตั้ง การตั้งค่า → การตั้งค่า build → คำสั่งเริ่มต้น เช่น:
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 และ worker อื่น ๆ
เพิ่ม Valkey ให้โปรเจกต์ แล้วชี้ Celery ไปที่ REDIS_URL รัน worker ได้ดังนี้:
- ที่แท็บ โปรเซส เป็น background worker —
celery -A myproject worker -l info - หรือเป็นเซอร์วิส background worker แยกที่มีทรัพยากรของตัวเอง
- Celery beat เป็น background worker อีกตัว —
celery -A myproject beat -l info— หรือใช้คำสั่งที่ทำซ้ำเป็นระยะเป็น คำสั่งตามกำหนดเวลา หรือ งานตามกำหนดเวลา
ดูที่ เซอร์วิสของโปรเจกต์
ไฟล์ที่คงอยู่ข้ามการ deploy
ทุกการ deploy เริ่มจากสำเนาใหม่ของรีโพสิทอรี ไฟล์ที่แอปพลิเคชันเขียนลงใน /data จะคงอยู่ข้ามการ deploy และสำรองข้อมูลทุกวัน ส่วนไฟล์ที่เขียนไว้ที่อื่นจะหายไปหลัง deploy ครั้งถัดไป สำหรับไฟล์ที่ผู้ใช้อัปโหลด ให้ใช้ object storage (สำหรับ Django ใช้ django-storages กับตัวแปร S3_*)
โปรเจกต์ Python อื่น ๆ
โปรเจกต์ Python ที่ไม่ได้ใช้เฟรมเวิร์กเหล่านี้ต้องมี Dockerfile ของตัวเองในรีโพสิทอรี จากนั้นเราจะ build ด้วยไฟล์นั้นตามที่เป็นอยู่