collectstatic لبيئة Production

أثناء التطوير، يعثر Django على الملفات الثابتة ويقدمها نيابةً عنك. أما في production، فتكون هذه الخدمة التلقائية متوقفة، لذا يجب أن تجمع الأصول في مكان واحد أولًا.

ينسخ الأمر collectstatic كل ملف ثابت من كل تطبيق إلى مجلد إخراج واحد، ليكون جاهزًا ليقدمه خادم ويب بسرعة.

يحتاج collectstatic إلى وجهة. يشير الإعداد STATIC_ROOT إلى المجلد الوحيد الذي ستُكتب فيه جميع الملفات المجمعة.

لا تضبط STATIC_ROOT أبدًا على مجلد تعدّله يدويًا. فهو مجلد output مُنشأ تلقائيًا، ويُعاد بناؤه عند كل تشغيل لـ collectstatic.

يجلب collectstatic الملفات من مجلد static لكل تطبيق ومن STATICFILES_DIRS، ثم يدمجها جميعًا في STATIC_ROOT في عملية واحدة.

يسألك الأمر افتراضيًا قبل الاستبدال. أضف --noinput إلى نص النشر ليعمل دون تدخل ومن دون انتظارك.

شغّل collectstatic عند كل عملية نشر بعد جلب الشيفرة الجديدة. ولن تصل ملفات CSS وJS الجديدة أو المعدلة إلى المستخدمين إلا بعد جمعها.

تضيف واجهة ManifestStaticFilesStorage تجزئة المحتوى إلى اسم كل ملف، لتجلب المتصفحات دائمًا أحدث إصدار بعد النشر.

لا يقدم Django نفسه STATIC_ROOT في بيئة الإنتاج. بل يقدم هذه الملفات خادم ويب مثل Nginx أو أداة مثل WhiteNoise.

أضف أنماط --ignore لتخطي الملفات التي لا تريد نسخها، مثل خرائط المصدر أو الملفات المؤقتة الموجودة في مجلد static.

بما أن STATIC_ROOT مُنشأ تلقائيًا، أضفه إلى .gitignore. التزم بملفات الأصول المصدرية، لا بالنسخ المجمعة.

رأيت أن بيئة الإنتاج تحتاج إلى collectstatic لدمج الأصول في STATIC_ROOT، وأنه يجب تشغيله عند كل عملية نشر، وأن خادم الويب يقدم النتيجة. 🚀