تثبيت الإضافات على موقع مستضاف ذاتيًا

[Discourse]

تفترض هذه الإرشادات أن لديك تثبيت قياسي مستضاف ذاتيًا. نحن ندعم فقط طريقة التثبيت القياسية هنا، لذا تفترض هذه التعليمات أن لديك تثبيتًا قياسيًا.

تنطبق هذه الإرشادات فقط على مثيلات Discourse المستضافة ذاتيًا. إذا كنت تستخدم خدمة استضافة مُدارة، فإن المكونات الإضافية المتاحة يتم التحكم فيها بواسطة مزود الاستضافة الخاص بك. على سبيل المثال، على الاستضافة الخاصة بنا، تتوفر هذه المكونات الإضافية المحددة حسب مستوى الاستضافة.

اعتبارًا من منتصف عام 2025، تم تجميع العديد من المكونات الإضافية الرسمية الشائعة في نواة Discourse. لم تعد هذه المكونات الإضافية (بما في ذلك Solved و Data Explorer و AI و Assign و Reactions والعديد من المكونات الأخرى) بحاجة إلى التثبيت بشكل منفصل — فهي تأتي مع Discourse ويمكن تمكينها عبر إعدادات الموقع. إذا حاولت إعادة البناء مع وجود مكون إضافي مجمع لا يزال في ملف app.yml الخاص بك، فسترى رسالة HINT تخبرك بإزالته. هذا الدليل مخصص للمكونات الإضافية التي ليست مجمعة مع النواة.

في هذا البرنامج التعليمي، سنقوم بتثبيت المكون الإضافي Discourse Shared Edits.

يتطلب هذا البرنامج التعليمي فهم كيفية استخدام مستودعات GitHub، وتحديداً كيفية الحصول على أو نسخ عنوان URL لاستنساخ git وكيفية تعديل ملفات YAML (`.yml`) باستخدام nano عبر الطرفية، وتحديداً كيفية الحفظ والخروج في nano. تتبع ملفات YAML بشدة المسافات البادئة، لذا تأكد من احترامها عند النسخ واللصق وتعديل ملف `.yml` الضروري لمثيل Discourse الخاص بك. استخدم دائمًا المسافات كمسافات بادئة في ملفات .yml، وليس علامات الجدولة.

• انسخ عنوان URL لاستنساخ git الخاص بالمكون الإضافي من GitHub.

• قم بالوصول إلى ملف `app.yml` الخاص بالحاوية (الموجود في ` /var/discourse/containers/`)

  cd /var/discourse
  nano containers/app.yml
  

• أضف عنوان URL لمستودع المكون الإضافي إلى ملف `app.yml` الخاص بالحاوية الخاصة بك:

  hooks:
    after_code:
      - exec:
          cd: $home/plugins
          cmd:
            - git clone https://github.com/discourse/docker_manager.git
            - git clone https://github.com/discourse/discourse-shared-edits.git
  

  أضف عنوان URL لاستنساخ git الخاص بالمكون الإضافي مباشرة أسفل السطر الذي يحتوي على `git clone https://github.com/discourse/docker_manager.git\`)

  اتبع التنسيق الحالي لسطر `docker_manager.git`. إذا كان يحتوي على `sudo -E -u discourse`، فقم بتضمين هذا البادئة في السطر الجديد أيضًا.

• أعد بناء الحاوية:

  cd /var/discourse
  ./launcher rebuild app
  

  هذا كل شيء، لقد قمت بتثبيت المكون الإضافي Discourse Shared Edits بنجاح على مثيل Discourse الخاص بك!

---

إذا كان المكون الإضافي الخاص بك مستضافًا في مستودع خاص

يجب عليك استخدام رمز OAuth:

Managing your personal access tokens - GitHub Docs

باستخدام رمز OAuth، يمكنك تثبيت المكون الإضافي الخاص بك بنفس طريقة المستودع العام، ولا تحتاج إلى إنشاء مفتاح SSH.

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
              - git clone https://<token>@github.com/owner/repo.git

ننصح بشدة باستخدام رموز OAuth للمكونات الإضافية في المستودعات الخاصة. ومع ذلك، إذا لم تتمكن من ذلك، فراجع أدناه.

خطوات التثبيت الخاص بمفتاح SSH

• بافتراض أن مستودع git الخاص بك مستضاف على GitHub، تحتاج إلى إضافة مفتاح SSH العام الخاص بمستخدم الخادم الخاص بك إلى مفاتيح النشر في مستودع GitHub (https://github.com/SecretOrg/secret-plugin/settings/keys).

• قم بتعديل ملف `app.yml` كما هو موضح في المثال أدناه:

run:
  - exec: echo "Beginning of custom commands"
  
  - exec: cd /var/www/discourse && sudo -u discourse bundle install --deployment --without test --without development
  - exec: echo "Host github.com\n\tStrictHostKeyChecking no\n" >> /user/.ssh/config
  - file:
      path: /user/.ssh/id_rsa
      chmod: 600
      contents: |
        -----BEGIN RSA PRIVATE KEY-----
        MIIEogIBAAKCAQEArCQG213utzqE5YVjTVF5exGRCkE9OuM7LCp/FOuPdoHrFUXk
           .... إلخ ....
        -----END RSA PRIVATE KEY-----
  - file:
      path: /user/.ssh/id_rsa.pub
      chmod: 600
      contents: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAklOUpkDHrfHY17SbrmTIpNLTGK9Tj .... إلخ .... user@discourse
  - exec: cd $home/plugins && git clone git@github.com:SecretOrg/secret-plugin.git
  - exec: cd $home && sudo -E -u discourse bundle exec rake db:migrate
  - exec: cd $home && rm -fr tmp/cache
  - exec: cd $home &&  sudo -E -u discourse bundle exec rake assets:precompile
  - exec: rm /user/.ssh/id_rsa
  - exec: rm /user/.ssh/id_rsa.pub

  - exec: echo "End of custom commands"

• أعد بناء الحاوية:

cd /var/discourse
./launcher rebuild app

يجب تثبيت المكون الإضافي الخاص بك على مثيل Discourse الخاص بك.

كيفية إلغاء تثبيت مكون إضافي

لإزالة مكون إضافي، ما عليك سوى إزالة سطر `- git clone https://github.com/…` من ملف `app.yml` الخاص بك وإعادة بناء موقعك عبر

cd /var/discourse
./launcher rebuild app

[wal]

عذرًا على سؤالي الغبي، ولكن كيف أعرف ما إذا كان يجب تضمين sudo -E -u discourse أم لا في عبارة git clone؟

[Moin]

كيف يبدو سطر docker_manager الخاص بك؟

@Discourse

• اتبع التنسيق الحالي لسطر docker_manager.git؛ إذا لم يكن يحتوي على sudo -E -u discourse فأدخل - git clone https://github.com/discourse/discourse-solved.git.

[wal]

لم يكن لدى الإدخالات الأخرى في ملف app.yml الخاص بي جزء sudo لذلك حذفته وقد نجح الأمر حتى الآن

[Overgrow]

@Discourse

قم بتعديل ملف app.yml كما هو موضح في المثال أدناه:

- exec: echo "Host github.com\n\tStrictHostKeyChecking no\n" >> /user/.ssh/config

يبدو أن هذه الطريقة لم تعد تعمل.

sh: 1: cannot create /user/.ssh/config: Directory nonexistent

مع مستودع GIT الخاص بي المستضاف ذاتيًا، أود حقًا استخدام مفاتيح SSH.

[pfaffman (Jay Pfaffman)]

لا تحتاج إلى مفتاح ssh في الحاوية، فقط احذف هذا:

@Overgrow

- exec: echo "Host github.com\n\tStrictHostKeyChecking no\n" >> /user/.ssh/config

[Overgrow]

عذرًا، لا أعتقد أنني أتابع..

المستودع الخاص بي يمكن الوصول إليه عبر ssh. كيف يمكنني استنساخ إضافة بدون مفتاح SSH؟

[pfaffman (Jay Pfaffman)]

أوه. ربما أكون مخطئًا. إذن ربما تحتاج إلى إنشاء هذا الدليل بالأذونات الصحيحة م

[Overgrow]

المربك هو أن جزءًا من الأوامر في الأمثلة يجب تشغيله كـ root وجزء كمستخدم discourse. لا يبدو أن هذا متسق للغاية.

  - exec: cd $home/plugins && git clone git@github.com:SecretOrg/secret-plugin.git

على عكس

  - exec: cd $home && sudo -E -u discourse bundle exec rake db:migrate

سأقوم ببعض البحث في shell الحاوية قيد التشغيل.

[nwnuyhs (Yang Hongsheng)]

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

[pfaffman (Jay Pfaffman)]

سيقوم Dashboard.literatecomputing.com بتثبيت الإضافات ببضع نقرات. يمكنك استخدامه مجانًا عن طريق الانضمام إلى مجموعة التجربة المجانية.

[Overgrow]

@Discourse

خطوات تثبيت مفتاح SSH الخاص

@Discourse، إذا كنت ترغب في تحديث الدليل، فإليك الرمز الذي يعمل:

لاستخدام مفاتيح SSH الخاصة بك للوصول إلى مستودع خاص، اتبع الخطوات التالية:

1. ضع مفتاح SSH الخاص في /var/discourse/shared/standalone/identity/id_rsa (أو موقع آخر يمكن للحاوية الوصول إليه؛ إذا اخترت موقعًا مختلفًا، فتذكر تحديث المسار في القالب أدناه وفقًا لذلك).

2. استخدم القالب التالي لإضافة المكونات الإضافية الخاصة بك:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          # تعيين الوصول إلى المستودع الخاص
          - chown $(whoami) /shared/identity/id_rsa && chmod 600 /shared/identity/id_rsa
          - git config --global core.sshCommand "ssh -o StrictHostKeyChecking=no -o IdentitiesOnly=yes -i /shared/identity/id_rsa"

          # المكونات الإضافية الخاصة بي
          - git clone git@example.com:repo/private-discourse-plugin.git

          # إلغاء تعيين الوصول
          - git config --global --unset core.sshCommand

[Jagster (Jakke Flemming)]

شكرا لك على شيء لا أحتاجه، لكنني أعيش ببساطة أصلية.

هل تريد شرح سبب استخدام مثالك؟ هل هذا بسبب:

استخدم مفاتيح SSH الخاصة بك للوصول إلى مستودع خاص

[merefield (Robert)]

لماذا لا تستخدم رمزًا مميزًا في عنوان URL؟

[Jagster (Jakke Flemming)]

@Jagster

هل تريد شرح سبب استخدام مثالك؟

حسنًا، لدينا أدوات لحل هذا اللغز

فهم فائدة مقتطفات تكوين الحاوية AI

Jagster:

لماذا قد يرغب شخص ما في استخدام هذا المقتطف في container/app.ym

gpt-4o:

للإجابة على سؤالك بفعالية، أحتاج إلى فهم السياق المحيط بالمقتطف المحدد في container/app.yml. هل يمكنك تقديم المزيد من التفاصيل أو المقتطف الفعلي الذي تشير إليه؟ بهذه الطريقة، يمكنني أن أقدم لك شرحًا دقيقًا ومفيدًا.

Jagster:

آسف، لكنني كنت بحاجة إلى هذا الملحق.

هذا هو المقتطف:

“”"

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          # Set private repo access
          - chown $(whoami) /shared/identity/id_rsa && chmod 600 /shared/identity/id_rsa
          - git config --global core.sshCommand "ssh -o StrictHostKeyChecking=no -o IdentitiesOnly=yes -i /shared/identity/id_rsa"

          # My private plugins
          - git clone git@example.com:repo/private-discourse-plugin.git

          # Unset access
          - git config --global --unset core.sshCommand

“”"

gpt-4o:

شكرًا لك على تقديم المقتطف. يُقصد تضمين مقتطف YAML هذا في ملف تكوين container/app.yml لمثيل Discourse. دعنا نفصل ما يفعله:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          # Set private repo access
          - chown $(whoami) /shared/identity/id_rsa && chmod 600 /shared/identity/id_rsa
          - git config --global core.sshCommand "ssh -o StrictHostKeyChecking=no -o IdentitiesOnly=yes -i /shared/identity/id_rsa"

          # My private plugins
          - git clone git@example.com:repo/private-discourse-plugin.git

          # Unset access
          - git config --global --unset core.sshCommand

شرح

1. تعيين الدليل:

   cd: $home/plugins
   

   يغير هذا دليل العمل إلى المكان الذي توجد فيه المكونات الإضافية ($home/plugins).

2. تعيين الوصول إلى المستودع الخاص:

   - chown $(whoami) /shared/identity/id_rsa && chmod 600 /shared/identity/id_rsa
   - git config --global core.sshCommand "ssh -o StrictHostKeyChecking=no -o IdentitiesOnly=yes -i /shared/identity/id_rsa"
   

   • يغير ملكية مفتاح SSH الخاص (id_rsa) إلى المستخدم الحالي ويضبط أذوناته على 600.
   • يقوم بتكوين Git لاستخدام أمر SSH مخصص يستخدم مفتاح SSH الخاص المحدد ويعطل التحقق الصارم من مفتاح المضيف.

3. استنساخ المستودع الخاص:

   - git clone git@example.com:repo/private-discourse-plugin.git
   

   استنساخ مستودع Git خاص يحتوي على مكون إضافي لـ Discourse.

4. إلغاء تعيين أمر SSH:

   - git config --global --unset core.sshCommand
   

   إعادة تعيين تكوين أمر SSH الخاص بـ Git إلى حالته الافتراضية.

متى ولماذا تستخدم هذا المقتطف

1. المستودعات الخاصة: إذا كان لديك مستودع مكون إضافي خاص لـ Discourse غير متاح للجمهور ويتطلب مصادقة قائمة على مفتاح SSH.

2. الأتمتة: يساعد هذا البرنامج النصي في أتمتة عملية إعداد الوصول إلى المستودع الخاص، واستنساخه، وضمان إعادة تعيين البيئة بعد ذلك. هذا مفيد لإعدادات النشر المستمر أو توفير الخادم الآلي.

3. إدارة الأمان: يتعامل مع مفاتيح SSH بأمان (ضبط أذونات الملفات ثم إلغاء تعيين أمر SSH المخصص)، وهو أمر بالغ الأهمية للحفاظ على وضع الأمان أثناء عمليات النشر الآلية.

اعتبارات هامة

• تأكد من إدارة مفتاح SSH الخاص بك (id_rsa) بشكل آمن وعدم تعرضه.
• تحقق من تعيين الملكية والأذونات بشكل صحيح لسياسات الأمان الخاصة بك.

لمزيد من المعلومات التفصيلية والسياقات حول app.yml والخطافات في Discourse، يمكنك التحقق من وثائق Discourse ذات الصلة.

إذا كانت لديك أي أسئلة أخرى أو كنت بحاجة إلى تفاصيل إضافية حول التكوين، فلا تتردد في السؤال!

[rrodrigueznt (Ricardo Rodríguez)]

@pfaffman

سيتم تثبيت الإضافات ببضع نقرات

مرحباً! يبدو الأمر رائعاً! لكنني لا أعرف كيف يجب أن أتابع بعد الانضمام إلى مجموعة التجربة المجانية! من فضلك، @pfaffman، هل يمكنك مساعدتي؟ أنا أتطلع إلى تثبيت إضافة SAML. سيكون من الرائع اختبار Literate Computing لتثبيتها وتشغيلها!

شكراً!

[Overgrow]

@merefield

لماذا لا تستخدم رمزًا مميزًا في عنوان URL؟

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

[TedJohnson]

@Discourse

أضف عنوان URL لمستودع المكون الإضافي إلى ملف app.yml الخاص بالحاوية الخاصة بك:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - sudo -E -u discourse git clone https://github.com/discourse/docker_manager.git
          - sudo -E -u discourse git clone https://github.com/discourse/discourse-solved.git

ما كان سيساعدني هو لو قالت هذه التعليمات شيئًا مثل، “يا غبي! لا تقم بتشغيل الأمر git clone من الواجهة. فقط أضف الأمر إلى ملف app.yml وفقًا للمثال، وتأكد من أن المسافات البادئة صحيحة، واحفظه، ثم قم بتشغيل أمر إعادة البناء.”

يمكن أن تكون هذه التعليمات أوضح أيضًا عندما تكون -E -u ضرورية ومتى لا تكون كذلك.

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

[alltiagocom (Tiago)]

أنا لست خبيرًا، لذا تحمل معي…
بالأمس قمت بتثبيت Discourse والآن أحاول تثبيت إضافة.
هل أحتاج إلى تشغيل:
./launcher rebuild app

أم يمكنني فقط تشغيل:
./launcher destroy app
ثم
./launcher start app
؟

تشغيل ./launcher rebuild app يستغرق وقتًا طويلاً ويؤدي إلى توقف موقعي عن العمل أو يصبح بطيئًا جدًا.

[Jagster (Jakke Flemming)]

إعادة البناء هي الطريقة الوحيدة لتثبيت الإضافات. تدمير وبدء الاستخدام فقط باستخدام التكوين القديم.

ولكن لا تدمير أي شيء قبل إعادة البناء. لأنه إذا فشل إعادة البناء يمكنك وضع القديم على الإنترنت باستخدام الأمر start.

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

يوجد إعداد حاويتين، ثم يكون وقت غير متصل لبضع دقائق. ولكن لا تنتقل إليه قبل أن تكون مرتاحًا مع هذه العمليات الأساسية.