ابدأ الآن

تطبيقات Python: Django وFlask وFastAPI.

كيف تُكتشف مشاريع Django وFlask وFastAPI وتُشغَّل، وأي نقطة دخول نبحث عنها، والملفات الثابتة، والترحيلات، وتشغيل Celery.

2 دقائق قراءة

المستودع الذي يحتوي على 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 خاص به في المستودع؛ ونبني به حينها كما هو.

ما زلت تحتاج إلى مساعدة؟

تحدّث معنا — يجيب AI فورًا وينضم مهندس عند الحاجة، في أي وقت من اليوم.

تواصل مع الدعم