التبديل بين قنوات/إصدارات Discourse

[Discourse]

يشرح هذا الدليل كيفية تكوين قناة الإصدار لنسخة Discourse الخاصة بك.

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

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

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

ملخص

توفر Discourse عدة قنوات لتتبع تحديثات البرامج: latest، وrelease، وesr. تشرح هذه الوثائق الغرض من كل قناة، وخصائصها الرئيسية، وكيفية تكوينها في نسخة Discourse الخاصة بك. للحصول على توضيح للقنوات، راجع releases.discourse.org.

القنوات المدعومة

latest

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

• مناسبة للمواقع التي تريد البقاء محدّثة.
• يمكن للمواقع التحديث يدويًا في أي وقت.

release

للمواقع التي تفضل الإصدارات الشهرية

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

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

esr

إصدار الدعم الممتد

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

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

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

أسماء مستعارة قديمة غير مستخدمة

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

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

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

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

تعليمات تكوين قناتك

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

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

cd /var/discourse
nano containers/app.yml

سيُفتح محرر nano ملف التكوين.
2. تعديل فرع التتبع
اعثر على معلمة الإصدار عن طريق البحث عن كلمة “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. إعادة بناء الحاوية
   بمجرد إجراء التغييرات وحفظها، أعد بناء الحاوية لتطبيق التكوين الجديد:

./launcher rebuild app

ستؤدي إعادة البناء إلى توقف مؤقت في الخدمة

[ghorbani (Aref)]

@Discourse

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

هل يُعدّ الأمر git pull خطوةً ضرورية، أم أنه متكرر ويأتي من الوثائق القديمة، على غرار حالة تحديث Discourse (التحديث اليدوي لـ Discourse وصورة Docker إلى أحدث إصدار)؟

[merefield (Robert)]

من خبرتي، فإن git pull يكون في بعض الأحيان مفيداً - على سبيل المثال، كان ضرورياً عندما انتقلنا من yarn إلى pnpm …

عادةً لا داعي للقلق بشأن إعادة البناء العادي.

[ghorbani (Aref)]

من الجيد أن أعرف ذلك! شكراً لك على المعلومات.

[merefield (Robert)]

ما أفعله عادةً هو محاولة إعادة البناء، وإذا فشل الأمر لسبب غير واضح تماماً، أجرب أولاً تشغيل git pull - يستغرق ذلك لحظة.

[david (David Taylor)]

نظرياً، لا ينبغي أن يكون ذلك ضرورياً أبداً. سيقوم المشغل (Launcher) بالكشف التلقائي عن نسخة قديمة وإجراء أمر git pull بنفسه:

launcher

[ghorbani (Aref)]

شكراً لك على التفاصيل. بالفعل، هذا منطقي. سأجرب الأمر دون استخدام git pul وأخبرك بالنتيجة.

[Ed_S]

هذا غريب. الكود المعني يعود لعام 2015، ومنتدىي يعود لعام 2018، ومع ذلك أنا متأكد تماماً من أن هناك عدة حالات تمت مناقشتها هنا حيث كان الأمر git pull ضرورياً.

من ناحيتي، سأقوم دائماً بتنفيذ git pull إذا تذكرت - فهذا لا يكلفني شيئاً.

[david (David Taylor)]

يتم ذكرها كثيرًا، وأعتقد ذلك بسبب هذه الوثائق التاريخية للغاية. لا أعتقد أنني رأيت أي دليل على أنها ساعدت بالفعل.

لكن نعم، لا ضرر من تشغيلها يدويًا أيضًا

[Ed_S]

@Discourse

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

بما أن ملف yml يستخدم version وليس supported tracking branch، هل من الجيد إضافة (version) إلى عنوان الموضوع؟

[ghorbani (Aref)]

لقد صُدمتُ أيضًا من التاريخ في البداية. ولكن بعد التحقق من سجل الإصدارات، كان آخر تحديث في 18 مايو.

[david (David Taylor)]

قمت بمحاولة تحديث المنشور الأصلي لاستخدام مصطلح “القنوات” الحديث لدينا، وإزالة بعض الإشارات غير الضرورية إلى git pull.

[merefield (Robert)]

يجب أن يكون هناك على الأقل حالة حدية، لأنه بالتأكيد “ساعدني على تجاوز العقبة” في مناسبات نادرة جداً

هل يمكن أن يكون ذلك عندما يتغير النص الرئيسي في ظروف محدودة؟