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

[Discourse]

تم اختبار هذا البرنامج التعليمي على Windows 10 و 11.

لإعداد بيئة تطوير لـ Discourse على Windows، يمكنك فعل ذلك باستخدام ميزة Windows Subsystem for Linux.

يتطلب هذا الإعداد تثبيت WSL 2. وهو متاح فقط في إصدارات Windows 10 18917 أو الأحدث. سنفترض أنك قمت بالفعل بتثبيت Windows Subsystem for Linux 2 (Ubuntu) على نظام Windows 10 الخاص بك. تحذير: قم بتثبيت Ubuntu 18.04، وليس 20.04، حيث قد تفشل بعض التثبيتات على 20.04. لمزيد من المعلومات، راجع ملاحظات 30 يونيو 2020 في أسفل هذا المنشور.

لنبدأ!

تثبيت Discourse

1. اتبع الخطوات الموضحة في الموضوع دليل المبتدئين لتثبيت Discourse على Ubuntu للتطوير في البداية حتى تصل إلى خطوة استنساخ Discourse.

@techAPJ

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

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

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

** اختياري

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

2. قبل إعداد قاعدة البيانات، يجب عليك بدء خدمة PostgreSQL وخادم Redis يدويًا باستخدام الأوامر التالية:

   sudo service postgresql start
   redis-server --daemonize yes
   

3. ثم تابع جميع الخطوات المتبقية من دليل Ubuntu.

@techAPJ

استنساخ Discourse

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

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

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

إعداد قاعدة البيانات

قم بإنشاء دور بنفس اسم مستخدم نظام ubuntu الخاص بك:

sudo -u postgres createuser -s "$USER"

تهيئة Discourse

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

cd ~/discourse

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

source ~/.bashrc
bundle install

الآن بعد أن قمت بتثبيت الـ gems بنجاح، قم بتشغيل الأوامر التالية:

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

جرب تشغيل الاختبارات:

bundle exec rake autospec

يجب أن تمر جميع الاختبارات.

ابدأ خادم rails:

bundle exec rails server

يجب أن تكون قادرًا الآن على الاتصال بتطبيق Discourse الخاص بك على http://localhost:3000 - جربه!

في مثيل طرفي منفصل، انتقل إلى مجلد discourse الخاص بك (cd ~/discourse) وقم بتشغيل:

bin/dev --only ember

هذا يبدأ مجمع الواجهة الأمامية؛ يظل التطبيق مُقدَّمًا من http://localhost:3000.

إنشاء أمر لبدء Discourse

الآن أصبحت بيئة التطوير الخاصة بك جاهزة تقريبًا. المشكلة الوحيدة هي أنه في كل مرة تفتح فيها Ubuntu على Windows، يجب عليك بدء خدمة PostgreSQL وخادم Redis يدويًا. لا تقلق، يمكننا إيجاد حل بديل لإنشاء أمر مخصص

cd ~

قم بإنشاء ملف جديد باستخدام الأمر nano start-discourse والصق المحتوى أدناه ثم احفظ الملف واخرج.

#!/bin/bash

# لبدء PostgreSQL
sudo service postgresql start

# لبدء خادم Redis
redis-server --daemonize yes

الآن قم بتعديل الصلاحيات (CHMOD) باستخدام الأمر التالي:

chmod +x start-discourse

ثم انسخ الملف إلى مجلد bin الخاص بك:

sudo cp start-discourse /usr/bin/

تم. الآن، كلما فتحت Ubuntu bash، ما عليك سوى تشغيل الأمر أدناه والبدء في التطوير

start-discourse

---

بدلاً من ذلك، إذا كنت تستخدم إصدارات Windows 10 Enterprise أو Pro أو Education، فيمكنك إنشاء آلة افتراضية Linux في hyper-v لإعداد بيئة تطوير Discourse.

ملاحظات حول بيئة Windows

اعتبارًا من 30 يونيو 2020:

@AndreaHabib

مع إصدار Windows 10 build 2004 و WSL 2، قد يواجه الكثير منكم بعض المشاكل حيث يتطلب Discourse الآن WSL 2 للعمل فعليًا.
للبدء: إذا لم تكن قد قمت بذلك بالفعل، فستحتاج إلى تحديث نظامك إلى Windows 2004 (19041).
ملاحظة: لا تقم بالتثبيت باستخدام Windows Update في إعدادات النظام حيث قد تواجه أخطاء أثناء التثبيت. تأكد أيضًا من أنك تعمل على Windows 1903 (18362) أو 1909 (18363)، يمكنك البحث عن winver للتحقق من ذلك.

• انتقل إلى: تحميل Windows 10
• انقر فوق زر “تحديث الآن” تحت تحديث Windows 10 مايو 2020 لتحميل مساعد التحديث ودعه يقوم بالتثبيت والإكمال.
• إذا حصلت على أي أخطاء، فقم بتحميل أداة إنشاء الوسائط، وشغّلها، وأنشئ محرك فلاش قابل للتمهيد (بحد أدنى 8 جيجابايت) واستخدمه لتثبيت Windows.

عند الانتهاء من تثبيت Windows، ستحتاج إلى تثبيت WSL 2 يدويًا.
ولكن أولاً، يجب التأكد من تمكين ميزتين:

• منصة الآلة الافتراضية (Virtual Machine Platform)، والتي يمكن تمكينها مباشرة من Windows عن طريق الانتقال إلى “البرامج والميزات” ثم تمكين “الميزات الاختيارية” في “تشغيل ميزات Windows أو إيقافها”.
• الأخرى هي “التخيل” (Virtualization)، والتي يمكن تمكينها فقط من BIOS. ومع ذلك، قد يختلف هذا الخيار من لوحة أم إلى أخرى. على سبيل المثال: في AMD يُسمى SVM. لذا يرجى البحث عن لوحة الأم الخاصة بك.

الآن بعد تمكين الميزتين:

• قم بتثبيت Ubuntu 18.04، وليس 20.04، حيث قد تفشل بعض التثبيتات على 20.04.
• اذهب إلى هنا وقم بتحديث نواة Linux: الرابط في الردود.
• اذهب إلى هذا الرابط واتبع الخطوات: تثبيت Windows Subsystem for Linux (WSL) على Windows 10 | Microsoft Docs
• اذهب إلى powershell (شغّل كمسؤول) وقم بتشغيل: wsl --set-version Ubuntu-18.04 2 أو wsl --set-version Ubuntu 2، أيًا من التوزيعات يظهر في wsl -l -v.
• يستغرق التحويل بعض الوقت، بضع دقائق.
• قم بتشغيل wsl -l -v للتأكد من تشغيل Ubuntu على WSL 2.

الآن يمكنك تشغيل Ubuntu-18.04 أو Windows Terminal مع Ubuntu والبدء في تثبيت التبعيات والأدوات.

ملاحظة: إذا واجهت خطأ أثناء تثبيت أحد الـ gems خلال bundle install: تأكد من أنك تعمل على Ubuntu-18.04 وليس 20.04.

ومع ذلك، إذا كان لديك postgreSQL 12 يعمل بالفعل على المنفذ 5432، فقد تواجه بعض المشاكل، حيث أن التبعيات تقوم بتثبيت PostgreSQL 10، مما قد يؤدي إلى زيادة المنفذ إلى 5433.
لحل ذلك:

• افتح مجلدك في محرر نصوص (مثل VS Code).
• اذهب إلى config/database.yml.
• تحت development وتحت adapter، أضف سطرًا جديدًا ثم أضف: port: 5433.
• تأكد من فعل نفس الشيء لـ test و profile.

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

لنواة Linux: تحديث نواة Linux لـ WSL 2 | Microsoft Docs

@RickyC0626

حل لا يتطلب تكوين المنفذ صراحة في database.yml

بعض الأخطاء أثناء إنشاء قاعدة البيانات والهجرة:

اتصال غير صالح بـ Redis لمنفذ محدد / رفض الاتصال

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

من هذا الخطأ يمكننا أن نرى أن المنفذ الذي يستخدمه Redis هو 6379، ويمكننا إصلاح ذلك عن طريق بدء خادم Redis عبر هذا المنفذ.

افتراضيًا، يجب أن يعمل redis-server --daemonize yes، ولكن إذا لم يعمل، استخدم:

redis-server --daemonize yes --port 6379

تحقق من حالة مثيل Redis:

redis-cli

127.0.0.1:6379> ping
PONG

اتصال غير صالح بمنفذ psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

من هذا الخطأ يمكننا أن نرى أن PostgreSQL يواجه مشكلة في الاتصال بالمنفذ 5432. عادةً ما يبدأ الخدمة ويعمل بشكل صحيح.

sudo service postgresql start

إذا لم ينجح ذلك واستمر الخطأ، فحاول التحقق من أي منفذ يستمع إليه الخدمة، وإذا لزم الأمر، غيّر المنفذ إلى المنفذ الذي تريده في postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

النتيجة

بمجرد القيام بالخطوات أعلاه أو تنفيذ أمر start-discourse، يجب أن يعمل المثيلان على منافذهما الافتراضية/المحددة. للتحقق من حالتهما عبر طرفية Windows الافتراضية cmd، يمكننا تشغيل:

netstat -anop tcp

التي ستظهر شيئًا مثل هذا:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

لقد تأكدنا الآن من أن كلا من مثيلي postgresql و redis-server يعملان.

يمكننا أيضًا التحقق من حالة المثيلات على Ubuntu أو WSL بالأوامر التالية:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

من هنا، يجب أن تعمل هذه الأوامر دون مشاكل كبيرة، دون الحاجة إلى تعديل ملف database.yml:

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

يمكن معالجة أي مشاكل إضافية تظهر في المستقبل.

اعتبارًا من 1 يوليو 2020

@RickyC0626

حل لا يتطلب تكوين المنفذ صراحة في database.yml

بعض الأخطاء أثناء إنشاء قاعدة البيانات والهجرة:

اتصال غير صالح بـ Redis لمنفذ محدد / رفض الاتصال

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

من هذا الخطأ يمكننا أن نرى أن المنفذ الذي يستخدمه Redis هو 6379، ويمكننا إصلاح ذلك عن طريق بدء خادم Redis عبر هذا المنفذ.

افتراضيًا، يجب أن يعمل redis-server --daemonize yes، ولكن إذا لم يعمل، استخدم:

redis-server --daemonize yes --port 6379

تحقق من حالة مثيل Redis:

redis-cli

127.0.0.1:6379> ping
PONG

اتصال غير صالح بمنفذ psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

من هذا الخطأ يمكننا أن نرى أن PostgreSQL يواجه مشكلة في الاتصال بالمنفذ 5432. عادةً ما يبدأ الخدمة ويعمل بشكل صحيح.

sudo service postgresql start

إذا لم ينجح ذلك واستمر الخطأ، فحاول التحقق من أي منفذ يستمع إليه الخدمة، وإذا لزم الأمر، غيّر المنفذ إلى المنفذ الذي تريده في postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

النتيجة

بمجرد القيام بالخطوات أعلاه أو تنفيذ أمر start-discourse، يجب أن يعمل المثيلان على منافذهما الافتراضية/المحددة. للتحقق من حالتهما عبر طرفية Windows الافتراضية cmd، يمكننا تشغيل:

netstat -anop tcp

التي ستظهر شيئًا مثل هذا:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

لقد تأكدنا الآن من أن كلا من مثيلي postgresql و redis-server يعملان.

يمكننا أيضًا التحقق من حالة المثيلات على Ubuntu أو WSL بالأوامر التالية:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

من هنا، يجب أن تعمل هذه الأوامر دون مشاكل كبيرة، دون الحاجة إلى تعديل ملف database.yml:

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

يمكن معالجة أي مشاكل إضافية تظهر في المستقبل.

---

تم المراجعة آخر مرة بواسطة @SaraDev في 2022-06-16T02:00:00Z

---

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