دليل إعداد بيئة تطوير Discourse (قديم) - GitHub Codespace

[jordan-violet]

يتضمن Discourse الأساسي الآن تكوين devcontainer محدثًا، مما يعني أن الخطوات اليدوية في الموضوع لم تعد مطلوبة.

تحقق من الوثائق الرسمية هنا: Developing Discourse on GitHub Codespaces

---

التطوير باستخدام GitHub Codespaces

GitHub Codespace هو خيار تطوير رائع. إنه رائع لأنه مستضاف في السحابة، يمكنني التأكد بسهولة من أن كل من يطور هنا لديه نفس البيئة، ولا توجد تعاملات مع تثبيتات Docker المحلية، وسهولة الوصول إلى جعل مثيل التطوير المحلي الخاص بي متاحًا للعامة، وأيضًا مجرد استخدام التكنولوجيا الجديدة أمر ممتع.

أنا حاليًا أعيد تعلم التطوير وقررت تبني GitHub Codespaces بالإضافة إلى تعلم بعض تطوير Discourse، لذلك قمت بإنشاء هذا الدليل لأي شخص آخر يتطلع إلى التطوير على Discourse في GitHub Codespace بدلاً من إعداد بيئة محلية.

قررت كتابة هذا الدليل بعد المرور بسلسلة من المشكلات في جعل هذا يعمل مع GitHub Codespace بنفسي:

Issues attempting to run discourse in GitHub Codespaces

Following this post from @cvx on a fresh GitHub codespace install: Running bin/ember-cli -u (FYI for anyone else, you first have to cd into workspace/discourse), nets the following issue: [image]

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

استنساخ مستودع Discourse

1. انتقل إلى https://github.com/discourse/discourse
   

   

2. انقر فوق الزر Fork في الجزء العلوي الأيمن من الصفحة وانقر فوق الزر الأخضر ‘Create fork’ في الصفحة التالية.
   

   

3. بعد لحظة وجيزة، سيتم نقلك إلى المستودع المستنسخ الجديد الخاص بك من مستودع discourse/discourse:
   

   

إعداد GitHub Codespace الخاص بك

1. انقر فوق الزر الأخضر <> Code
   

   

2. قم بالتبديل إلى علامة التبويب Codespaces وانقر فوق الزر الأخضر Create codoespace on main.
   

   

3. سيتم نقلك إلى نافذة جديدة حيث سيبدأ GitHub في إنشاء مساحة الكود الخاصة بك. يجب أن يستغرق هذا من 1 إلى 3 دقائق:
   

4. بعد بضع دقائق، سيتم تقديم مساحة الكود الخاصة بـ GitHub لك (وهي مجرد VS Code في متصفحك):
   

   

إعداد بيئة مساحة الكود الخاصة بك

هناك بعض التكوينات التي يجب إجراؤها على بيئة مساحة الكود الخاصة بك قبل أن تكون جاهزًا للعمل.

1. قم بإنشاء shell bash جديد بالنقر فوق Ctrl + Shift + backtick على Windows/Linux، أو Cmd + Shift + backtick على Mac. يجب أن يبدأ shell الخاص بك في الدليل /var/www/discourse.
   

   

2. انتقل إلى دليل discourse:

cd workspace/discourse

3. قم بتثبيت كل شيء من ملف Gemfile الخاص بالمشروع

bundle install --gemfile ./Gemfile

الأمر طويل جدًا، لكنك سترى شيئًا كهذا:

4. أضف ملف config.hosts جديد إلى development.rb
   1. من الدليل الذي تتواجد فيه حاليًا (/var/www/discourse/workspace/discourse) افتح الملف config/environments/development.rb.
   2. ابحث عن السطر config.hosts << /\A(([a-z0-9-]+\.)*localhost(\:\d+)?\Z/ وأنشئ سطرًا جديدًا أسفله مع ما يلي، ثم احفظ الملف:

config.hosts << /^(.*)\.app\.github\.dev$/

يجب أن يبدو الجزء الأخير من ملفك كالتالي (لاحظ السطر 102 في لقطة الشاشة الخاصة بي):

5. بالعودة إلى الطرفية، قم بتشغيل bundle exec rake admin:create لإنشاء حساب المسؤول الأول الخاص بك. سيطلب منك الأمر اختيار بريد إلكتروني وكلمة مرور (يجب أن تكون كلمة المرور 10 أحرف على الأقل)
   
   

ابدأ محركاتك الخادم الخاص بك

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

1. في نفس الطرفية التي تتواجد فيها، قم بتشغيل الأمر التالي لبدء الخادم الخاص بك:

bin/ember-cli -u

2. قم بالتبديل من علامة التبويب Terminal إلى علامة التبويب PORTS في وحدة التحكم الخاصة بك:
   

   

3. انقر فوق Forwarded Address للمنفذ 4200 باستخدام Ctrl + click لنظام Windows/Linux، أو Cmd + click لنظام Mac وسيتم الترحيب بك في بيئة التطوير الخاصة بك!
   

   

نأمل أن يساعد هذا شخصًا آخر في البدء باستخدام GitHub Codespaces!

[Rick_Jing]

رائع، إنه خيار جيد عند السفر بخفة

[jordan-violet]

أو في حالتي، لا أرغب حقًا في التطوير على نظام ويندوز ودوكر، ولكني أيضًا لا أرغب في الانتقال إلى بيئة يونكس في المنزل (على الرغم من أنني أستخدم واحدة في العمل).

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

[NateDhaliwal]

أعتقد أن هذا الدليل يحتاج إلى بعض التحديثات. لا يعمل عند تشغيل الخطوة 5، حيث لم يتم إنشاء قواعد البيانات بعد.

[NateDhaliwal]

@jordan-violet

bundle exec rake admin:create

تمكنت من جعله يعمل عن طريق تشغيل

bash <(wget -qO- https://raw.githubusercontent.com/discourse/install-rails/main/linux)

ثم

bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate

متبوعًا بـ

bin/ember-cli -u

ثم في طرفية منفصلة

bin/rails admin:create

[NateDhaliwal]

@jordan-violet أفترض أن هذا #unsupported-install؟ لا يمكنني العثور على app.yml الخاص بي، لذلك لا يمكنني تثبيت الإضافات.

[Moin]

لتثبيت إضافة، يمكنك اتباع الخطوات الموجودة في Install plugins in your non-Docker development environment

[merefield (Robert)]

تقوم بإنشاء رابط رمزي من مجلد الإضافات الخاص بك إلى مجلد كود الإضافة الخاص بك

[david (David Taylor)]

@jordan-violet شكراً لإنشاء هذا الدليل بكل الحلول البديلة التي كانت ضرورية سابقاً
يسرني أن أقول إننا قمنا الآن بدمج مجموعة من التغييرات في تكوين devcontainer/codespaces الخاص بنا، والتي يجب أن تجعل الأمور أسهل بكثير دون الحاجة إلى إنشاء نسخة متفرعة أو تكوين أي شيء يدوياً.
إليك الدليل الرسمي:

Developing Discourse on GitHub Codespaces

GitHub Codespaces is a very fast way to get started with Discourse development. Their free tier is good for 30 hours per month of a 4-core machine. Getting Started Navigate to the github repository Press the , (comma) key on your keyboard, to open GitHub codespaces Use ‘change options’ to customize the machine. Technically, the 2-core machine will work, but we recommend using at least 4-core for a better experience. [Codespace config] Click “Create Codespace” Wait for the contai…

سأضيف ملاحظة في أعلى المنشور الأصلي هنا، لتوجيه الأشخاص إلى الأدلة الرسمية