كيف تنشر تطبيق Django للإنتاج؟

Question

Accepted Answer

نشر Django للإنتاج يتضمن تشغيله خلف **خادم WSGI/ASGI** مناسب و**خادم ويب**، خدمة الملفات الثابتة بشكل صحيح، تأمين الإعدادات، وإدارة قاعدة البيانات — مختلف تماماً عن خادم التطوير المدمج (الذي **ليس** للإنتاج).

## Stack الإنتاج

```text
Client → NGINX (web server) → GUNICORN (WSGI app server) → DJANGO
           │                      (runs your Python app, multiple workers)
           └─ serves static/media files directly (efficient)

❌ NEVER use `python manage.py runserver` in production — it's single-threaded,
   insecure, and not built for load. Use Gunicorn (WSGI) or Uvicorn (ASGI for async).
```

خادم التطوير غير مناسب للإنتاج. Stack القياسي: **خادم تطبيق** (Gunicorn/uWSGI لـ WSGI، Uvicorn لـ ASGI/async) يشغل Django مع عدة workers، خلف **خادم ويب** (nginx) يتعامل مع الاتصالات الواردة و TLS والملفات الثابتة.

## إعدادات الإنتاج (حرجة للأمان)

```python
DEBUG = False                            # ❗ MUST be False — DEBUG=True leaks sensitive info
ALLOWED_HOSTS = ["example.com"]          # required when DEBUG=False
SECRET_KEY = os.environ["SECRET_KEY"]    # from the environment, NOT committed
SECURE_SSL_REDIRECT = True               # force HTTPS
SESSION_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000
```

## الملفات الثابتة

```bash
python manage.py collectstatic           # gather static files into STATIC_ROOT
# then serve them via nginx or a CDN — or use WhiteNoise to serve them from the app
# (Django does NOT serve static files itself in production)
```

## قاعدة البيانات والهجرات

```bash
python manage.py migrate                  # apply migrations to the production DB
# use a real database (PostgreSQL), connection pooling, regular backups
```

## قائمة التحقق من النشر النموذجية

```text
1. Set production environment variables (SECRET_KEY, DB credentials, DEBUG=False)
2. Run migrations (manage.py migrate)
3. Collect static files (collectstatic) → serve via nginx/CDN/WhiteNoise
4. Run the app with Gunicorn/Uvicorn (multiple workers, behind nginx)
5. Enable HTTPS (TLS certificates, e.g. Let's Encrypt)
6. Set up logging, error monitoring (Sentry), health checks
7. Add a process manager (systemd/supervisor) or use containers (Docker) + orchestration
8. Run `manage.py check --deploy` to audit security settings
```

## نهج النشر الحديث

```text
✓ Containers (Docker) + orchestration (Kubernetes) or platforms (Heroku, Railway, Render)
✓ Managed databases, separate static/media storage (S3 + CDN)
✓ Background workers (Celery) + a broker (Redis) as separate services
✓ Horizontal scaling: multiple app instances behind a load balancer (keep app STATELESS)
```

## لماذا يهم

نشر Django للإنتاج بشكل صحيح هو معرفة أساسية لنقل التطبيقات من التطوير إلى الاستخدام الواقعي، وينطوي على اعتبارات مهمة تختلف بشكل جذري عن التطوير المحلي — الخطأ فيه يؤدي إلى ثغرات أمان أو ضعف الأداء أو تطبيقات معطلة.

فهم **stack الإنتاج** أساسي: خادم التطوير المدمج (`runserver`) بوضوح ليس للإنتاج (هو single-threaded، غير آمن، ولا يستطيع التعامل مع الحمل)، لذا يجب تشغيل Django خلف **خادم تطبيق** مناسب (Gunicorn/uWSGI لـ WSGI، أو Uvicorn لـ ASGI/async) مع عدة workers، مسبوق بـ **خادم ويب** (nginx) يتعامل مع الاتصالات و TLS وخدمة الملفات الثابتة.

عدة جوانب حرجة للأمان والصحة: **إعدادات الإنتاج** (خاصة `DEBUG=False`، وهو إلزامي لأن `DEBUG=True` يسرب tracebacks الحساسة والتكوين للمهاجمين، بالإضافة إلى `ALLOWED_HOSTS`، `SECRET_KEY` سري من البيئة، وفرض HTTPS)، **معالجة الملفات الثابتة** (تشغيل `collectstatic` وخدمة الملفات عبر nginx/CDN/WhiteNoise، لأن Django لا يخدمها بنفسه في الإنتاج — فشل نشر شائع)، و**إدارة قاعدة البيانات** (قاعدة بيانات حقيقية مثل PostgreSQL، تطبيق الهجرات، النسخ الاحتياطية).

معرفة قائمة التحقق من النشر، والنهج الحديثة (Docker/containers، المنصات المدارة، التخزين السحابي للملفات، عمال Celery كخدمات منفصلة، التوسع الأفقي مع تطبيق بدون حالة)، والاهتمامات التشغيلية (logging، المراقبة مع Sentry، فحوصات الصحة، إدارة العمليات) هي ما يفصل النشر الإنتاجي الفعلي عن النشر الهش أو غير الآمن.

لأن كل تطبيق Django حقيقي يجب في النهاية أن يُنشر، ولأن أخطاء النشر (ترك `DEBUG=True`، سوء معالجة الملفات الثابتة، كشف الأسرار، استخدام خادم التطوير) تسبب مشاكل أمان وموثوقية حقيقية، فهم كيفية نشر Django بشكل صحيح — stack، الإعدادات الحرجة للأمان، معالجة الثابتة والملفات، وممارسات النشر الحديثة — هي معرفة مهمة عالية المخاطر تعكس القدرة على نقل التطبيقات جاهزة للإنتاج، موضوع متكرر الصلة واحترافي بالضرورة لأي مطور Django مسؤول عن الأنظمة الحية.