هل أغفلت شيئًا في توثيقي القصير لمسؤولي منتديات Discourse التي ساعدت في إعدادها؟

لقد قمت بإعداد منتديات Discourse للعديد من الأصدقاء/الجمعيات. أود أن يكونوا أكثر استقلالية في الإدارة، لذلك سأكون أقل عرضة للتدخل بنفسي.

لقد استخدموا Discourse كمستخدمين ومديري مشاركين لعدة أشهر أو سنوات. إنهم ليسوا “مديرين جدد”، لكنهم يفتقرون إلى المعرفة المتعمقة حول كيفية صيانة Discourse يوميًا (خارج أساسيات الإشراف) وما يجب معرفته كمسؤول، وفي حالة حدوث مشاكل تقنية، لأنني كنت دائمًا موجودًا لرعاية مثل هذه الأمور.

سأظل متاحًا في المستقبل، ولكن الهدف هو تمكينهم من تتبع ومعالجة المشكلات الأكثر شيوعًا بأنفسهم.

إليك ما كتبته حتى الآن (مترجم بواسطة الذكاء الاصطناعي إلى الإنجليزية لأن نصوصي ستُكتب بالفرنسية، لذا لا تهتم إذا كانت بعض الجمل مكتوبة بطريقة غريبة):


التحديثات

عبر واجهة الويب

قم بتشغيل التحديثات عندما تظهر وجه مبتسم أحمر غير سعيد في لوحة الإدارة (فهذا يعني وجود تحديث مهم يجب تطبيقه).
يتم التحديث عبر:
https://tonforum.fr/admin/upgrade

تتم أحيانًا على خطوتين: قد تحتاج أولاً إلى تحديث “Docker_Manager” قبل أن تتمكن من ترقية الباقي:

عبر سطر الأوامر

في بعض الأحيان، يجب إجراء تحديث عبر سطر الأوامر (ستخبرك صفحة إدارة Discourse بذلك صراحةً إذا لزم الأمر).

  1. اتصل بالخادم عبر SSH
  2. أعد بناء المنتدى (إعادة البناء تقوم دائمًا بتحديث Discourse) باستخدام الأمر التالي:
  3. /var/discourse/launcher rebuild app
    
  4. من وقت لآخر، بمجرد التأكد من أن المنتدى يعمل بشكل صحيح، قد يكون من المفيد إزالة صور Docker غير المستخدمة (بقايا الترقيات السابقة) لتحرير مساحة القرص:
    /var/discourse/launcher cleanup
    

موقع الملفات الهامة على الخادم

app.yml

يحتوي على تكوين الخادم وقائمة المكونات الإضافية المثبتة. مفيد جدًا إذا كنت بحاجة إلى ترحيل المنتدى إلى خادم آخر أو تطبيق تكوينات معينة (على سبيل المثال، نقل التحميلات والنسخ الاحتياطي إلى قرص آخر). يقع هنا:

/var/discourse/containers/app.yml

mail-receiver.yml

يحتوي على تكوين البرنامج الذي يسمح باستقبال الردود عبر البريد الإلكتروني ونشرها على المنتدى. يقع هنا:

/var/discourse/containers/mail-receiver.yml

النسخ الاحتياطي

يتم تخزين ملفات النسخ الاحتياطي هنا:

/var/discourse/shared/standalone/backups/default

الصفحات الهامة في إدارة المنتدى

بعض الصفحات التي قد تكون مفيدة :robot:

السمات والمكونات

تتضمن CSS و HTML مخصصين:

https://tonforum.fr/admin/config/customize/themes

السجلات (Logs)

البريد الإلكتروني

مفيد لتصحيح الأخطاء:

https://tonforum.fr/admin/email-logs

إجراءات الموظفين (Staff actions)

مفيد جدًا. يحتفظ بسجل لـ (تقريبًا) جميع تغييرات إعدادات الموقع والإجراءات الأخرى التي يقوم بها المشرفون والمديرون.

https://tonforum.fr/admin/logs/staff_action_logs

سجلات الأخطاء (Error logs)

يمكن أن توفر أدلة عندما لا تكون المشكلة واضحة:

https://tonforum.fr/logs/

النسخ الاحتياطي

لتغيير تكرار النسخ الاحتياطي والحد الأقصى لعدد النسخ الاحتياطية، أو عرضها، أو تنزيلها:

https://tonforum.fr/admin/backups

الموارد

https://meta.discourse.org
الدعم الرسمي. لا تتردد في النشر هناك؛ عادةً ما يكون أعضاء المجتمع والمطورون متعاونين للغاية.


هل ترى أي أشياء يمكن إضافتها/إزالتها؟ أعتقد أنه يمكنني إزالة جزء /logs/، لأنه نادر الاستخدام للغاية. لست متأكدًا حتى مما إذا كنت قد وجدت معلومات مفيدة فيه على مدى سنوات من إدارة بعض المثيلات.

10 إعجابات

هناك بعض الأمور التي أود توضيحها.

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

الأمر الآخر هو أنه إذا أصبح المضيف الخاص بك غير متاح أو تالفًا، فستحتاج إلى ملفات النسخ الاحتياطي وملفات yml. ستحتاج إلى الاحتفاظ بها بالفعل في مكان آمن على نظام منفصل.

للجمع بين الأمرين: قم دائمًا بعمل نسخة احتياطية، وقم بتنزيل النسخة الاحتياطية، قبل محاولة التحديث.

3 إعجابات

مرحباً إد، نقاطك صالحة جداً. أتذكر أن أحد الأعضاء قام بإنشاء برنامج نصي للنسخ الاحتياطي إلى نظام آخر منذ فترة. سأحتاج إلى البحث والتحقق

إليك مقتطف من المنشور الأصلي. لدى Canapin رد جيد مع رابط للنسخ الاحتياطي إلى Google Drive) Dropbox أيضًا)

@Canapin مع أداة إعادة بناء المشغل (launcher rebuild app)، ألا تحتاج إلى تشغيلها كـ

./launcher r build app

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

كتابة جيدة ومفيدة.

إعجاب واحد (1)

ولكن بما أنك ستنتقل إلى /var/discourse قبل ذلك، فإن ./ سيشير ببساطة إلى ذلك الدليل، لذا فإن مسار المشغّل (launcher) هو في الأساس /var/discourse/launcher، أليس كذلك؟

لم أكن على علم بذلك. لقد كنت أستخدمه للتو وفقًا للبرامج التعليمية الأخرى حول ديسكورس (Discourse). ولكن هذا منطقي. شكرًا لك.

أتساءل عما إذا كان من المفيد إضافة بعض نصائح التصعيد؟ إذا كان الشخص الذي يقرأ المستند لا يعرف كيفية الاتصال المباشر بالمضيف (ssh into the host) للتحقيق أو الإصلاح، فمن يمكنه ذلك؟ ربما نصيحة حول طرح الأسئلة هنا في الميتا (meta)، وربما نصيحة حول استخدام ask.

4 إعجابات

هذا جيد أن أعرف. كنت أعرف فقط عن تنزيل النسخة الاحتياطية التي أنشأها المنتدى نفسه.

إعجاب واحد (1)

شكرًا لمساعدتك!

لقد أضفت هذا في بداية الدليل الخاص بي:

تأكد من أنك مستعد لأي موقف

يوصى بشدة، بالإضافة إلى النسخ الاحتياطية المحلية (المحفوظة على نفس الخادم الذي يوجد عليه المنتدى)، بالاحتفاظ بنسخة من هذه النسخ الاحتياطية على خادم آخر أو في السحابة [1].

من المفيد أيضًا الاحتفاظ بنسخة من الملف /var/discourse/containers/app.yml في مكان آمن [2]. يُستخدم هذا الملف الاختياري في حالة إعادة تثبيت المنتدى أو الترحيل إلى خادم آخر.

إذا كان هناك أي شك كبير بشأن أي شيء، فاتصل بي (canapin@gmail.com).

أضفت هذا في قسم التحديث:

:information_source: قبل إجراء تحديث، يوصى بشدة بتنزيل أحدث نسخة احتياطية من منتدىك.

أضفت هذا:

ماذا تفعل إذا توقف المنتدى عن العمل؟

إعادة بناء المنتدى يحل العديد من المشاكل ويتم بنفس الأمر المستخدم في تحديث سطر الأوامر:

/var/discourse/launcher rebuild app

ماذا لو استمر المنتدى في عدم العمل بعد إعادة البناء؟

اتصل بي (canapin@gmail.com) أو انشر في منتدى الدعم الرسمي.

لقد ذكرت أيضًا ask.discourse.org في نهاية الدليل.

الموارد

https://meta.discourse.org : الدعم الرسمي، لا تتردد في النشر هناك — أعضاء المجتمع والمطورون مفيدون للغاية
https://ask.discourse.com : روبوت محادثة تم تدريبه على دعم وبيانات Discourse، فعال بشكل مدهش في الإجابة على الأسئلة (نعم، حقًا)

النص الكامل

تأكد من أنك مستعد لأي موقف

يوصى بشدة، بالإضافة إلى النسخ الاحتياطية المحلية (المحفوظة على نفس الخادم الذي يوجد عليه المنتدى)، بالاحتفاظ بنسخة من هذه النسخ الاحتياطية على خادم آخر أو في السحابة [1:1].

من المفيد أيضًا الاحتفاظ بنسخة من الملف /var/discourse/containers/app.yml في مكان آمن [2:1]. يُستخدم هذا الملف الاختياري في حالة إعادة تثبيت المنتدى أو الترحيل إلى خادم آخر.

إذا كان هناك أي شك كبير بشأن أي شيء، فاتصل بي (canapin@gmail.com).

التحديثات

:information_source: قبل إجراء تحديث، يوصى بشدة بتنزيل أحدث نسخة احتياطية من منتدىك.

عبر الواجهة

قم بالتحديثات عندما يكون هناك وجه مبتسم أحمر غير سعيد في المسؤول (فهذا يعني أن هناك تحديثًا مهمًا يجب القيام به).
يتم التحديث عبر https://yourforum.com/admin/upgrade

في بعض الأحيان يتم ذلك على خطوتين: قد تحتاج أولاً إلى تحديث “Docker_Manager” قبل أن تتمكن من ترقية الباقي:

عبر سطر الأوامر

في بعض الأحيان، يجب إجراء التحديث عبر سطر الأوامر (ستخبرك صفحة مسؤول Discourse بذلك إذا لزم الأمر).

  1. اتصل بالخادم عبر SSH
  2. أعد بناء المنتدى (إعادة البناء تقوم دائمًا بتحديث Discourse) باستخدام الأمر التالي:
  3. /var/discourse/launcher rebuild app
    
  4. من وقت لآخر، بعد التأكد من أن المنتدى يعمل بشكل صحيح، قد يكون من المفيد إزالة صور Docker غير المستخدمة (بقايا الترقيات السابقة) لتحرير مساحة القرص:
    /var/discourse/launcher cleanup
    

ماذا تفعل إذا توقف المنتدى عن العمل؟

إعادة بناء المنتدى يحل العديد من المشاكل ويتم بنفس الأمر المستخدم في تحديث سطر الأوامر:

/var/discourse/launcher rebuild app

أعتقد أنه جيد جدًا الآن وأنني لم أغفل أي شيء مهم :slight_smile:


  1. إذا قمت بتثبيت المنتدى الخاص بك، فسيتم نسخ النسخ الاحتياطية الخاصة بك تلقائيًا إلى Google Drive الخاص بي، ولكن من الناحية المثالية في المستقبل يجب حفظها في مساحة أنت مسؤول عنها. سنتحدث عن ذلك يومًا ما :smile: ↩︎ ↩︎

  2. يحتوي على اسم المستخدم وكلمة المرور لخادم البريد بالإضافة إلى بريد المسؤول على المستوى الأعلى (الخاص بي، في الواقع). ↩︎ ↩︎

3 إعجابات

إذا نجح هذا، فسيكون توصية أفضل (أبسط) من الإصدار المعتاد المكون من سطرين (والذي كان يتكون من ثلاثة أسطر، لذا يمكننا الاستمرار في هذا الاتجاه).

كلاهما يعمل.

إذا كنت في الدليل ./ مطلوب لأن موقع المشغل (launcher) ليس في المسار (path).

يتطلب نظام لينكس (Linux) أنه إذا لم يكن الأمر في المسار، يجب عليك إعطاء المسار الكامل له حتى لا يكون هناك أي خطأ بشأن الملف الذي قصدته.

3 إعجابات

نعم، ولكن غالبًا قد تكون بصدد القيام بأشياء متعددة، على سبيل المثال، التنظيف أولاً. وفي هذه الحالة، قد يكون الانتقال أولاً أكثر إيجازًا.

3 إعجابات

أوافق وقد قمت بحفظ الموضوع في الإشارات المرجعية للاستخدام المستقبلي، شكرًا لك

حسنًا، إليك الدليل المترجم تلقائيًا بالكامل:

التأكد من استعدادك لأي طارئ

يوصى بشدة، بالإضافة إلى النسخ الاحتياطية المحلية (المخزنة على نفس الخادم مثل المنتدى)، بالاحتفاظ بنسخة من تلك النسخ الاحتياطية على خادم آخر أو في السحابة [1].

من المفيد أيضًا الاحتفاظ بنسخة من الملف /var/discourse/containers/app.yml في مكان آمن [2]. هذا الملف الاختياري مفيد في حالة إعادة تثبيت المنتدى أو ترحيله إلى خادم آخر.

إذا كانت لديك أي شكوك جدية بشأن أي شيء، فاتصل بي.

التحديثات

:information_source: قبل إجراء تحديث، يوصى بشدة بتنزيل أحدث نسخة احتياطية من منتدىك.

عبر الواجهة

قم بالتحديثات عندما يكون هناك وجه مبتسم أحمر غير سعيد في المشرف (فهذا يعني أن هناك تحديثًا مهمًا يجب القيام به).
يتم التحديث عبر https://tonforum.fr/admin/upgrade

في بعض الأحيان تحدث التحديثات على خطوتين: قد تحتاج أولاً إلى تحديث “Docker_Manager” قبل أن تتمكن من ترقية الباقي:

عبر سطر الأوامر

قد يتطلب التحديث أحيانًا أن يتم عبر سطر الأوامر (ستخبرك صفحة مشرف Discourse بذلك إذا كان ضروريًا).

  1. اتصل بالخادم عبر SSH
  2. أعد بناء المنتدى (إعادة البناء تقوم دائمًا بتحديث Discourse) باستخدام الأمر التالي:
  3. /var/discourse/launcher rebuild app
    
  4. من وقت لآخر، بعد التأكد من أن المنتدى يعمل بشكل صحيح، قد يكون من المفيد إزالة صور Docker غير المستخدمة (بقايا الترقيات السابقة) لتحرير مساحة القرص:
    /var/discourse/launcher cleanup
    

ماذا تفعل إذا توقف المنتدى عن العمل؟

إعادة بناء المنتدى تصلح العديد من المشاكل ويتم بنفس الأمر المستخدم للتحديث عبر سطر الأوامر:

/var/discourse/launcher rebuild app

ماذا لو استمر المنتدى في عدم العمل بعد إعادة البناء؟

اسألني أو انشر على منتدى الدعم الرسمي.

موقع الملفات الهامة على الخادم

app.yml

يحتوي على إعدادات الخادم وقائمة المكونات الإضافية المثبتة. مفيد جدًا إذا احتاج المنتدى إلى نقله إلى خادم آخر، أو لبعض الإعدادات (نقل التحميلات والنسخ الاحتياطية إلى قرص آخر، على سبيل المثال). يقع هنا:

/var/discourse/containers/app.yml

mail-receiver.yml

يحتوي على إعدادات البرنامج الذي يسمح باستقبال الردود عبر البريد الإلكتروني ونشرها على المنتدى. يقع هنا:

/var/discourse/containers/mail-receiver.yml

النسخ الاحتياطية

توجد ملفات النسخ الاحتياطي هنا:

/var/discourse/shared/standalone/backups/default

الصفحات الهامة في مشرف المنتدى:

صفحات قد تكون مفيدة :technologist:

السمات والمكونات

تحتوي على، من بين أمور أخرى، CSS و HTML مخصصين:

https://tonforum.fr/admin/config/customize/themes

السجلات (Logs)

البريد الإلكتروني

مفيد لتصحيح الأخطاء:

https://tonforum.fr/admin/email-logs

إجراءات الموظفين (Staff actions)

مفيدة جدًا. تحتفظ بسجل لـ (تقريبًا) جميع تغييرات إعدادات الموقع وإجراءات المشرف والمسؤول الأخرى.

https://tonforum.fr/admin/logs/staff_action_logs

سجلات الأخطاء (Error logs)

يمكن أن تعطي أدلة عندما تكون هناك مشكلة يكون سببها غير واضح.

https://tonforum.fr/logs/

النسخ الاحتياطية

لتغيير تكرار النسخ الاحتياطي والعدد الأقصى، وعرضها، أو تنزيلها:

https://tonforum.fr/admin/backups

الموارد

https://meta.discourse.org : الدعم الرسمي، لا تتردد في النشر هناك، الأعضاء والمطورون يسعدون بالمساعدة
https://ask.discourse.com : روبوت محادثة تم تدريبه على دعم وبيانات Discourse، فعال بشكل مدهش في الإجابة على الأسئلة (نعم، حقًا)


  1. إذا قمت بتثبيت منتدىك، يتم نسخ النسخ الاحتياطية الخاصة بك تلقائيًا إلى Google Drive الخاص بي، ولكن من الناحية المثالية في المستقبل يجب حفظها في مساحة أنت مسؤول عنها. سنتحدث عن ذلك يومًا ما :smile: ↩︎

  2. يحتوي على المعرّف وكلمة المرور لخادم البريد، بالإضافة إلى البريد الإلكتروني للمسؤول (الخاص بي، في الواقع). ↩︎

3 إعجابات