تكوين فرع تتبع مدعوم للحصول على تحديثات برامج Discourse

[Discourse]

يشرح هذا الدليل كيفية تكوين فرع تتبع مدعوم لمثيل Discourse الخاص بك لإدارة تحديثات البرامج.

مستوى المستخدم المطلوب: مسؤول النظام

الوصول إلى وحدة التحكم (Console) مطلوب.

تحدد إدارة فرع التتبع لمثيل Discourse الخاص بك تكرار ونوع التحديثات التي تتلقاها. يشرح هذا الدليل الفروع المختلفة المتاحة للتتبع ويوفر نهجًا خطوة بخطوة لتغيير الفرع في الإعداد الخاص بك.

الملخص

يوفر Discourse العديد من الفروع (branches) والعلامات (tags) لتتبع تحديثات البرامج: latest، وrelease، وesr. توثق هذه الوثائق الغرض من كل منها، وسماتها الرئيسية، وكيفية تكوينها في مثيل Discourse الخاص بك. للحصول على تفاصيل كاملة حول نموذج الإصدار، راجع RFC: استراتيجية إصدار جديدة لـ Discourse.

الفروع المدعومة

latest

الإعداد الافتراضي الموصى به
يوفر هذا الفرع أحدث إصلاحات الأخطاء وتحديثات التوافق للمكونات الإضافية. يتم اختبار كل تثبيت (commit) يمر عبر الفرع main بواسطة خادم البناء ويُضاف إلى الفرع latest بعد التحقق الناجح.

• مناسب للمواقع التي ترغب في البقاء على اطلاع دائم.
• يمكن للمواقع التحديث يدويًا في أي وقت.

release

للمواقع التي تفضل الإصدارات الشهرية
يتتبع الوسم release أحدث إصدار شهري لـ Discourse. في كل شهر، يتم إنشاء فرع إصدار (مثل release/2026.2) من latest، مما يوفر لقطة مستقرة.

• يتم إصداره مرة واحدة تقريبًا كل شهر.
• يتلقى كل إصدار إصلاحات حرجة لدورتي إصدار كاملتين.

esr

إصدار الدعم الممتد (Extended Support Release)
يتتبع الوسم esr أحدث إصدار دعم ممتد، وهو مخصص للمواقع التي تعطي الأولوية للاستقرار والأمان طويل الأمد على التحديثات المتكررة.

• يتم الإعلان عنه تقريبًا كل 6 أشهر من الإصدارات الشهرية.
• يتلقى إصلاحات أمنية وإصلاحات خلفية حرجة لفترة ممتدة.
• قد يكون له توافق محدود مع المكونات الإضافية المجتمعية ومكونات السمات (theme components).

ملاحظة: عدم تلقي تحديثات صيانة منتظمة يمكن أن يترك بعض الميزات قديمة أو غير متناسقة بصريًا.

الأسماء المستعارة المهملة

للتوافق مع الإصدارات السابقة، لا تزال أسماء الفروع/الوسوم القديمة التالية تعمل ولكنها تعتبر مهملة:

• tests-passed ← latest
• beta ← release
• stable ← esr

الفروع أو المراجع الأخرى

من الممكن تتبع فروع أخرى (على سبيل المثال، فروع release/YYYY.M محددة أو التزام SHA محدد)، ولكنه يتطلب خبرة. تتلقى هذه الفروع إصلاحات حرجة فقط لفترة محدودة.

إرشادات تكوين فرع التتبع الخاص بك

اتبع هذه الخطوات لتكوين الفرع المطلوب في مثيل Discourse الخاص بك:

1. الوصول إلى ملف التكوين
   افتح ملف التكوين app.yml عن طريق تشغيل الأوامر التالية في وحدة التحكم الخاصة بك:

cd /var/discourse
git pull
nano containers/app.yml

سيفتح محرر nano ملف التكوين.
2. تعديل فرع التتبع
حدد موقع معلمة الإصدار (version) بالبحث عن كلمة “version” في الملف:

params:  
## Which Git revision should this container use? (default: latest)  
#version: latest

• قم بإلغاء التعليق عن سطر الإصدار.
• استبدل latest باسم الفرع أو الوسم المطلوب (على سبيل المثال، esr). مثال:

params:  
## Which Git revision should this container use? (default: latest)  
version: esr  

3. الحفظ والخروج

• اضغط على Ctrl+O لحفظ التغييرات.
• اضغط على Enter للتأكيد.
• استخدم Ctrl+X للخروج من المحرر.

4. إعادة بناء الحاوية
   بمجرد إجراء التغييرات وحفظها، أعد بناء الحاوية لتطبيق التكوين الجديد:

git pull
./launcher rebuild app

قد تتسبب هذه العملية في انقطاع مؤقت للخدمة. تأكد من تحديث المثيل خلال ساعات غير العمل إذا أمكن.