تطبيقات 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، أو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 (أضفه إلى البرمجيات الوسيطة) أو من تخزين الكائنات. - الترحيلات — أمر الإصدار الموصى به هو
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__) # ← يُشغَّل بصيغة 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 — باستخدام 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 خاص به في المستودع؛ ونبني به حينها كما هو.