أوضاع القراءة فقط في Discourse

:bookmark: يشرح هذا الدليل أوضاع القراءة فقط المختلفة المتوفرة في Discourse، وكيفية تمكينها وتعطيلها، والسيناريوهات التي قد ترغب في استخدام كل وضع فيها.

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

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

توفر Discourse أوضاع قراءة فقط مختلفة يمكن للمسؤولين تمكينها لتجميد أنواع مختلفة من التفاعلات داخل الموقع مؤقتًا.

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

فهم أوضاع القراءة فقط

يدعم Discourse مستويين مختلفين من أوضاع القراءة فقط المصممة لتناسب احتياجات إدارية متنوعة. وهي:

  1. وضع القراءة فقط الكامل

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

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

تضمن هذه الأوضاع المرونة في إدارة تشغيل المنتدى خلال فترات إدارية حرجة.

كيفية تمكين/تعطيل أوضاع القراءة فقط

:warning: يجب على المسؤولين إدارة الانتقال بين أوضاع القراءة المختلفة بعناية. قبل تمكين أي وضع قراءة فقط، تأكد من تعطيل أي وضع تم تنشيطه مسبقًا.

وضع القراءة فقط الكامل

عبر وحدة تحكم Rails

إذا كان لديك حق الوصول إلى تثبيت Discourse الخاص بك، فاستخدم واجهة سطر أوامر Discourse rails لتنفيذ الأمر التالي بعد الدخول إلى حاوية Docker الخاصة بك باستخدام ./launcher enter app ثم وحدة تحكم rails باستخدام rails c:

Discourse.enable_readonly_mode(Discourse::USER_READONLY_MODE_KEY)

عبر لوحة تحكم المسؤول

إذا كان لديك حق الوصول الإداري عبر واجهة الويب، يمكنك الانتقال إلى Admin > Backups > Enable Read-Only Mode لتمكين وضع القراءة فقط.

لتعطيل وضع القراءة فقط، قم بتنفيذ أمر rails التالي:

Discourse.disable_readonly_mode(Discourse::USER_READONLY_MODE_KEY)

أو، استخدم لوحة تحكم المسؤول بالانتقال إلى Admin > Backups > Disable Read-Only Mode.

وضع كتابة الموظفين فقط

:discourse: لا يمكن تمكين / تعطيل وضع كتابة الموظفين فقط إلا من وحدة تحكم Rails الخاصة بـ Discourse. إذا كان موقعك مستضافًا بواسطة Discourse، فيرجى التواصل مع team@discourse.org إذا كنت ترغب في تمكين أو تعطيل أي من هذين الوضعين.

لتمكين وضع كتابة الموظفين فقط، استخدم أمر وحدة تحكم Rails التالي:

Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)

للتعطيل:

Discourse.disable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)

أفضل الممارسات

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

الأسئلة الشائعة

  • كم من الوقت يستغرق تمكين/تعطيل وضع القراءة فقط؟

    • التغيير فوري. ومع ذلك، قد تختلف تجربة المستخدم قليلاً اعتمادًا على إجراءاتهم خلال فترة الانتقال.
  • مساعدة! لقد تم قفلي من موقعي بسبب وضع القراءة فقط - ماذا يمكنني أن أفعل للوصول إلى موقعي مرة أخرى؟

  • لاحظت أن هناك أوضاع READ-ONLY أخرى مدرجة في discourse/lib/discourse.rb، ماذا تفعل هذه الأوضاع؟

    • يُستخدم READONLY_MODE_KEY بشكل أساسي لعملية النسخ الاحتياطي والاستعادة ويتم تشغيله بواسطة التطبيق نفسه. يمكن أيضًا تمكين هذا الوضع أو تعطيله من واجهة سطر أوامر Discourse باستخدام discourse enable_readonly و discourse disable_readonly. ومع ذلك، لن ينجو هذا المفتاح من إعادة تشغيل الحاوية.
    • يُستخدم USER_READONLY_MODE_KEY عندما ينقر المسؤول على زر القراءة فقط في واجهة المسؤول. الشيء الخاص بهذا المفتاح هو أننا لا نحدده كمفتاح منتهي الصلاحية لأن القراءة فقط التي يتم تمكينها بواسطة المستخدم تحتاج إلى البقاء على قيد الحياة بعد إعادة تشغيل الحاوية. يتم تعيين المفاتيح الأخرى بـ TTL مدته 60 ثانية ولدينا خيط لتمديد انتهاء الصلاحية كل 30 ثانية لضمان عدم تعليق التطبيق أبدًا في وضع القراءة فقط.
    • يُستخدم PG_READONLY_MODE_KEY و PG_FORCE_READONLY_MODE_KEY لفشل PG. يتم تعيين الأول كمفتاح منتهي الصلاحية بينما الثاني غير منتهي الصلاحية.
9 إعجابات

لا أرى فرقًا! هل يمكن تعديل هذه الأوصاف وفقًا لذلك، إذا كان هناك بالفعل فرق؟

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

لقد قمت بتحديث الدليل لتقديم توضيح إضافي هنا، يُرجى إخبارنا إذا كانت لا تزال لديك أي أسئلة حول أي من أوضاع القراءة فقط. :slightly_smiling_face:

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

ولكن ماذا يفعل الأمر

discourse enable_readonly؟

إنه يستخدم READONLY_MODE_KEY، والذي يضبط ttl على 60، لذا يتم إيقافه مرة أخرى في مرحلة ما. الآن أرى أن

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

في رأيي، سيكون الشيء الأكثر منطقية الذي يقوم به discourse enable_readonly هو تنفيذ Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY). أتمنى لو لاحظت ذلك منذ سنوات عديدة!

هل يمكنني تقديم طلب سحب (PR) شيء كهذا:

  desc "enable_readonly", "تمكين وضع القراءة فقط، مما يسمح بكتابة الموظفين"
  def staff_writes_only
    load_rails

    Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)
    puts 'الموقع الآن في وضع القراءة فقط مع السماح بكتابة الموظفين.'
  end

لستُ على دراية تامة بهذا، ولكني أعتقد أنه سيكون مربكًا لـ enable_readonly_mode تعيين الموقع إلى staff_writes_only_mode. إنهما وضعان مختلفان، عند إجراء عمليات معينة، لن ترغب في السماح للموظفين بالكتابة في قاعدة البيانات (أثناء الاستعادة، على سبيل المثال، سيتم إزالتهم).

ربما يمكننا بدلاً من ذلك القيام ببعض الأشياء الأخرى هنا:

  1. توضيح أن وضع القراءة فقط يحدد وقتًا محددًا (TTL) في وصف تلك المهمة.
  2. إضافة مهمة تستدعي keep_readonly_mode حتى يمكن تمديدها لأكثر من 60 دقيقة.
  3. إضافة مهام enable_staff_writes_only و disable_staff_writes_only.
إعجابَين (2)

أتفق، ولكن سيكون أقل إرباكًا من “تعيين وضع القراءة فقط لفترة من الوقت”.

أنا متأكد من أن نص الاستعادة يضبط وضع القراءة فقط بنفسه، لذلك لا يتأثر بهذا الأمر.

أفضل أن يعلن أنه تم تعيينه لمدة X دقائق عند تعيينه. ليس من السهل العثور على الوصف.

ربما. لست متأكدًا من سيستخدمها.

سيكون ذلك رائعًا!

أيضًا، نحتاج إلى توضيح أننا لا نخلط بين مهام rake والأوامر المتاحة من خلال أمر discourse.

إعجابَين (2)

منطقي. هل هناك أي فرصة لتقديم هذا كـ PR؟ نفس الشيء بالنسبة لأوامر enable_staff_writes_only و disable_staff_writes_only، إن أمكن. شكراً!

3 إعجابات

أنا فضولي بشأن أي الساعات تتوقف بعد بدء التشغيل في وضع القراءة فقط؟ هل ستحدث ارتفاعات في الموضوع بعد تعيين وضع القراءة فقط؟

يبدو أيضًا أن التحديثات لا تعمل إذا تم تعيين وضع القراءة فقط بواسطة واجهة مستخدم الويب