تثبيت Discourse على macOS لأغراض التطوير

[Discourse]

يغطي هذا الدليل تعليمات التثبيت لبيئة تطوير على macOS. للحصول على أدلة الإنتاج، راجع: Install Discourse in production with the official supported instructions

إذن، تريد إعداد Discourse على نظام macOS للعمل عليه والتطوير؟

سنفترض أنك لم تقم بتثبيت Ruby/Rails/Postgres/Redis على جهاز Mac الخاص بك. لنبدأ !

تثبيت تبعيات Discourse

ستحتاج إلى الحزم التالية على نظامك:

• Git
• rbenv أو asdf
• ruby-build
• Ruby (أحدث إصدار مستقر)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** اختياري

أعد تشغيل طرفيتك (Terminal)

الآن بعد أن قمنا بتثبيت تبعيات Discourse، لننتقل إلى تثبيت Discourse نفسه.

إعادة تشغيل طرفيتك (Terminal)

يضمن الخروج من الـ Shell وإعادة تشغيله أن يتم التقاط المسارات الخاصة بالحزم المثبتة بشكل صحيح من قبل الطرفية.

استنساخ Discourse

قم باستنساخ مستودع Discourse في مجلد ~/discourse:

git clone https://github.com/discourse/discourse.git ~/discourse

~ تشير إلى مجلد المنزل، لذا سيكون كود مصدر Discourse متاحًا في مجلد المنزل الخاص بك.

تهيئة Discourse

انتقل إلى مجلد Discourse الخاص بك:

cd ~/discourse

قم بتثبيت الـ gems المطلوبة

bundle install

قم بتثبيت تبعيات JS

pnpm install

بعد ذلك، قم بتشغيل الأوامر التالية لإعداد مثيل Discourse المحلي الخاص بك:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

قم بتشغيل خوادم Rails و Ember، لديك خياران هنا.

الخيار 1: باستخدام علامتي تبويب/نوافذ طرفية منفصلتين، قم بتشغيل Rails و Ember CLI بشكل منفصل عبر

bundle exec rails server

و

bin/ember-cli

الخيار 2: باستخدام علامة تبويب/نافذة طرفية واحدة فقط:

bin/ember-cli -u # سيقوم بتشغيل خادم Pitchfork في الخلفية

يجب أن تكون قادرًا الآن على التنقل إلى http://localhost:4200 لرؤية تثبيت Discourse المحلي الخاص بك. (لاحظ أن التحميل الأول قد يستغرق ما يصل إلى دقيقة حيث يتم تدفئة الخادم.)

يمكنك أيضًا تجربة تشغيل المواصفات (specs):

bundle exec rake autospec

يجب أن تنجح جميع الاختبارات (أو تقريبًا جميعها).

إنشاء مسؤول جديد

لإنشاء مسؤول جديد، قم بتشغيل الأمر التالي:

RAILS_ENV=development bundle exec rake admin:create

اتبع المطالبات لإنشاء حساب مسؤول.

تكوين البريد

قم بتشغيل MailHog:

mailhog

---

تهانينا! أنت الآن مسؤول تثبيت Discourse الخاص بك!

استمتع بالتطوير! ولبدء ذلك، راجع دليل المبتدئين لإنشاء إضافات Discourse.

---

يتم التحكم في إصدار هذا المستند - اقترح تغييرات على GitHub.

[jamesmarkcook (James Cook)]

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

[henrikbg (Henrik Berg)]

Is it possible to reset a discourse completely?

[techAPJ (Arpit Jalan)]

@Henrik_B

Is it possible to reset a discourse completely?

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

[Chaboi_3000]

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

[techAPJ (Arpit Jalan)]

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

[Chaboi_3000]

@techAPJ

git pull origin master

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

[techAPJ (Arpit Jalan)]

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

[Decorbuz]

باستخدام الدليل من منتدى Ruby on Rails، عالق حالياً في الخطوة 7.

هذا على الأرجح سؤال “للمبتدئين” جداً، لكن كيف يمكنني “التوجيه” إلى الفرع التجريبي الذي تم ربطه في ذلك الموضوع؟ جربت عدة أشياء وفي النهاية ظهر لي رسالة Unknown command mini_racer في كل مرة.

[blake (Blake Erickson)]

لا بأس بسؤالهم هنا.

هناك بعض التعليمات المحددة الخاصة بـ M1 التي كتبناها ونشير إليها في منتدى Rails في هذا الدليل.

@Decorbuz

ربما هذا سؤال “للمبتدئين” جدًا، لكن كيف يمكنني “توجيه” الفرع التجريبي الذي تم ربطه في ذلك الموضوع؟

سأحتاج إلى التحقق من جهاز M1 Air الخاص بي لاحقًا، وربما زملائي الذين قاموا مؤخرًا بإعداد أجهزة Mac جديدة قد يعرفون بشكل أفضل ما إذا كان هذا لا يزال ضروريًا، ولكن هناك مثال يوضح كيفية التوجيه إلى فرع في الخطوة 7:

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

لذا، ستقوم بتعديل هذا السطر في النسخة المحلية من ملف discourse/Gemfile:

Gemfile

ثم قم بتشغيل أمر bundle install.

[Decorbuz]

@pfaffman

إذا لم تكن قد اتبعت هذه التعليمات (لم أرَ خطوة 7) فإن هذا ليس المكان المناسب لطرح سؤالك.

إنه مرتبط مباشرة في أعلى المنشور الأصلي.

موضوع منتدى Ruby on Rails متوقف منذ شهور عديدة. لم يكن صاحب المنشور الأصلي نشطًا منذ فبراير ولم يرد على أي تعليقات هناك تطلب المساعدة.

هناك المزيد من الأشخاص الذين يمكنهم مساعدتي هنا. مجرد قول.

@blake

هناك مثال يوضح كيفية الإشارة إلى فرع في الخطوة 7:

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

لقد حاولت نسخ ذلك إلى Terminal وتلقيت نفس الخطأ Unknown command mini_racer من قبل.

اعترافًا، فإن الدليل من منتدى Ruby on Rails ليس واضحًا كما أتمنى في هذا الصدد.

أعتذر مسبقًا…

[blake (Blake Erickson)]

@Decorbuz

لقد حاولت نسخ ذلك إلى Terminal وتلقيت نفس الخطأ “Unknown command mini_racer” من قبل.

هذا ليس أمرًا للتشغيل. ستحتاج إلى تعديل ملف النص الفعلي المسمى “Gemfile” الموجود داخل مجلد discourse.

[Decorbuz]

@blake

ستحتاج إلى تعديل ملف النص الفعلي المسمى “Gemfile” الموجود داخل مجلد discourse.

آه!

شكرًا لك! دعني أجرب ذلك الآن.

في رأيي، يجب على شخص ما تعديل الدليل من منتدى Ruby on Rails وتقديم توضيح إضافي بشأن الخطوة 7. هذا مجرد رأيي الشخصي.

سأعود حالاً. انتظر لحظة…

[blake (Blake Erickson)]

عذراً، يجب أن أذهب، لكنني أعتقد أن إصلاح mini_racer لحواسيب M1 قد تم دمجه. لقد تحققت للتو من ملف Gemfile الخاص بي على حاسوب M1، ولم يتم تعديله. لذا أعتقد أنه يمكنك تخطي الخطوة 7.

[Decorbuz]

نفّذت الخطوة 8 وحصلت على خطأ Could not locate Gemfile.

أعتقد أنني تمكنت من فهم الخطوة 7، لكن الخطوة 8 لا تزال تسبّب لي مشكلة وتُظهر الخطأ المذكور أعلاه.

[blake (Blake Erickson)]

@Decorbuz

نفذت الخطوة 8 وتلقيت خطأ “لم يتم العثور على ملف Gemfile”.

يجب أن تكون داخل مجلد discourse عند تشغيل أمر bundle install.

@techAPJ

استنساخ Discourse

استنسخ مستودع Discourse في مجلد ~/discourse:

git clone https://github.com/discourse/discourse.git ~/discourse

~ تشير إلى مجلد المنزل، لذا سيكون كود مصدر Discourse متاحًا في مجلد منزلك.

تهيئة Discourse

انتقل إلى مجلد Discourse الخاص بك:

cd ~/discourse

قم بتثبيت الجيمات المطلوبة

bundle install

[JQ331]

@merefield

في الواقع، الأمر يتجاوز بضعة دولارات قليلاً (إنه خادم VPS بسعة 4 جيجابايت و8 أنوية - ربما مبالغ فيه) لكنه يسمح لي بالتطوير من أي مكان وعلى أي منصة. أداؤه ممتاز، لكن ستظل هناك تأخيرات بضع ثوانٍ عند إعادة تشغيل خادم الويب.

مرحبًا @merefield: هل يمكنك وصف إعدادك عن بُعد بمزيد من التفصيل؟

بينما يتيح لي تطوير قالب إضافة تغييرات على موقع مباشر، إلا أنني لا أرى أي بديل عن تطوير الإضافة على جهاز الكمبيوتر المحلي، مع وجود قاعدة كود Discourse كاملة هناك (مع إضافتي فوقها).

النتيجة هي أن أي تغيير (غير CSS) عند برمجة إضافة، عند إعادة التحميل 1) يُشغّل مروحة جهاز الكمبيوتر الخاص بي و2) يستغرق 30 ثانية كاملة لإعادة التحميل. وإذا احتجت إلى إعادة تشغيل الخادم، فقد يستغرق الأمر عدة دقائق.

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

لذلك، سأقدر أي اقتراحات لتسريع الأمور.

[merefield (Robert)]

ربما يكون من الأفضل مناقشة هذا في موضوع أوبونتو، حيث أنني أقوم بتشغيل التثبيت هذا على خادم سحابي، محمي بواسطة nginx ونظام DNS كامل (بدون Docker)، لذا أنا أعالج النطاق فعليًا. كل شيء يُدار من طرف السطر الأوامر. بل إنني نجحت في تشغيل Ember CLI بشكل جيد في هذا الإعداد الآن.

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

أسرع بيئة لتطوير الإضافات على الإطلاق، حسب علمي، هي [Docker Dev على WSL2] محليًا (Install Discourse for development using Docker) والتي تعمل بسرعة فائقة. كما أنها سهلة الصيانة للغاية. للأسف، لا يعمل discourse_theme في تلك البيئة حتى الآن، حسب علمي، لذا عدت إلى الخادم السحابي الخاص بي للعمل على ذلك.

من الغريب بعض الشيء لماذا تتأخر شركة Apple في هذا المجال؟ فقد أثبت مهندسو مايكروسوفت ذكاءهم ودهاءهم.

[Nacho_Caballero]

في حال واجه شخص ما أخطاء عند محاولة تثبيت ruby 2.7.3، يبدو أن شيئًا ما قد تغير بعد Xcode 12 مما يكسر عملية التثبيت باستخدام rbenv:

installing older Ruby versions on OSX after XCode 12

استمررت في الحصول على هذا، على الرغم من أن لدي أحدث إصدارات من psych و libyaml مثبتة:

يبدو أن تثبيت ruby الخاص بك يفتقد psych (لإخراج YAML).
للتخلص من هذا التحذير، يرجى تثبيت libyaml وإعادة تثبيت ruby الخاص بك.

لقد جربت الحل البديل الذي يقترحونه في الدليل، لكنني استمررت في الحصول على نفس الخطأ وانتهى بي الأمر إلى الاضطرار إلى استخدام rvm:

rvm install 2.7.3

[JQ331]

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