تثبيت بوابة "خدمات مطوِّري البرامج"

بوابة خدمات المطوّرين، الإصدار 4.16.05

اتّبِع الخطوات التالية لتثبيت بوابة "خدمات قناة المطوّر".

قبل متابعة التثبيت، احتفظ بنسخة احتياطية من دليلك الأساسي على الويب في Drupal. الموقع التلقائي للتثبيت هو /var/www/html، ولكن يمكنك تغييره في وقت التثبيت. بعد تنفيذ خطوات التثبيت الموضحة أدناه، يمكنك استعادة تخصيصاتك من النسخة الاحتياطية.

1- الحصول على حزمة "خدمات قناة المطوّر"

انتقِل إلى http://community.apigee.com/content/apigee-customer-support واختَر "تسجيل الدخول إلى بوابة الدعم" لطلب ملف .tar لخدمات قناة المطوّر بإحدى الطريقتَين التاليتَين:

• اطلب الوصول إلى دليل تنزيل Edge for Private Cloud.
• اطلب عنوان URL لملف .tar لخدمات قناة المطوّر.

2. التأكّد من أنّ نظامك يستوفي متطلبات النظام

قبل تثبيت البوابة، يجب أن يستوفي الخادم المتطلبات التالية:

1. تأكَّد من إجراء عملية التثبيت على الإصدار 64 بت من إصدار متوافق من Red Hat Enterprise Linux أو CentOS أو Oracle. يمكنك الاطّلاع على قائمة الإصدارات المتوافقة هنا.
2. تأكد من تثبيت Yum.
3. (لإجراء تثبيت على خادم بدون اتصال بالإنترنت) يجب أولاً تنزيل جميع الملفات اللازمة على خادم متصل بالإنترنت كملف .tar.gz واحد. يمكنك بعد ذلك نسخ ملف .tar.gz هذا إلى الخادم بدون الاتصال بالإنترنت لتنفيذ عملية التثبيت.
   1. سجّل الدخول إلى خادم متصل بالإنترنت كجذر أو كمستخدم متميز.
   2. أنشئ دليلاً لملفات التثبيت، مثل portal_tar.
   3. قرص مضغوط إلى الدليل الجديد ونزِّل الملف DeveloperServices_x.y.z.tar ، حيث يتوافق x.y.z مع رقم إصدار البوابة.
   4. استخرِج محتوى ملف .tar في "خدمات قناة المطوّر" باستخدام الأمر:
      > tar -xvf <tar file>
   5. قرص مضغوط إلى DeveloperServices-4.x.y.z.
   6. أنشِئ ملف tar.gz للمدخل باستخدام الأمر:
      > ./non-networked-install.sh
      
      يؤدي هذا الأمر إلى تنزيل جميع الملفات المطلوبة وحفظها في ملف .tar.gz واحد. يمكنك بعد ذلك نسخ ملف .tar.gz هذا إلى الخادم الذي لا يتصل بالإنترنت لإكمال عملية التثبيت.
4. اختبِر الاتصال بخادم إدارة Edge من خلال تنفيذ أمر cURL التالي من موجّه الأوامر على خادم البوابة:
   > curl -u {EMAIL}:{password} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   حيث يكون عنوان ORGNAME} وEMAIL للبريد الإلكتروني وEMAIL
   
   احرص على تحديد اسم المضيف ورقم المنفذ الخاصَّين بتثبيت Edge. المنفذ 8080 هو المنفذ التلقائي الذي يستخدمه Edge. "mod :Atrial : "Modified n the Cloud، "[س
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   

3. تثبيت "خدمات قناة المطوّر" باستخدام النص البرمجي للتثبيت المبرمَج

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

1. سجّل الدخول إلى الخادم كجذر أو كمستخدم متميز.
2. أنشئ دليلاً لملفات التثبيت، مثل البوابة.
3. على خادم متصل بالإنترنت:
   1. قرص مضغوط إلى دليل البوابة الجديد ونزِّل ملف DeveloperServices_x.y.z.tar إلى دليل خدمات قناة المطوّر، حيث يتوافق x.y.z مع رقم إصدار البوابة.
      
      يمكنك تنزيل ملف من الرابط الذي تم إرساله إليك من خلال Apigee في متصفّح أو عن طريق نسخه ثم إضافته إلى أمر cURL التالي:
      > curl -kOL <paste link here>
   2. استخرِج محتوى ملف .tar في "خدمات قناة المطوّر" باستخدام الأمر:
      > tar -xvf <tar file>
   3. قرص مضغوط إلى DeveloperServices-4.x.y.z.
   4. شغِّل النص البرمجي للتثبيت باستخدام الأمر التالي:
      > ./networked-install.sh
4. على خادم غير متصل بالإنترنت:
   1. انسخ ملف .tar.gz الذي أنشأته أعلاه في القسم 2. تأكَّد من أنّ نظامك يستوفي متطلبات النظام.
   2. استخرِج محتوى ملف .tar.gz باستخدام الأمر:
      > tar -xvf <tar file>
   3. القرص المضغوط إلى الدليل الذي أنشأه الأمر tar.
   4. اضبط الأذونات في النص البرمجي install-from-rpm-bundle.sh:
      > chmod 755 install-from-rpm-bundle.sh
   5. شغِّل النص البرمجي install-from-rpm-bundle.sh باستخدام الأمر:
      > ./install-from-rpm-bundle.sh
5. عليك الإجابة على الطلبات.
6. بعد اكتمال التثبيت، انتقِل إلى عنوان URL للخادم في أحد المتصفحات، مثل:
   http://localhost. أو إذا تم ضبط عنوان IP أو نظام أسماء نطاقات محدَّد، انتقِل إلى http://IP_address أو http://DNS_name.
   
   ستتم إعادة توجيهك إلى صفحة إعداد قاعدة بيانات ملف Apigee الشخصي.
   
   ملاحظة: عادةً ما تكون قد أعددت اسم المضيف وسجّلته في خادم نظام أسماء النطاقات حتى لا تضطر إلى استخدام http://localhost.
7. ضبط الاتصال بـ MySQL. إذا كان MySQL على جهاز بعيد، يمكنك توسيع قسم Advanced Options (الخيارات المتقدمة) وإدخال معلومات الاتصال بذلك الجهاز، ثم اختيار Save and continue (حفظ ومتابعة).
8. اضبط عملية الربط بنقطة نهاية Apigee من خلال إدخال المعلومات التالية، ثم اختَر حفظ:
   لمزيد من المعلومات عن هذه القيم، راجِع القسم "معلومات مطلوبة قبل بدء التثبيت" في متطلبات بوابة خدمات المطوّرين.
   1. بوابة مطوّري البرامج للمؤسسات
   2. عنوان URL لنقطة نهاية بوابة مطوّري البرامج
   3. مستخدم مصادق عليه نقطة النهاية
   4. كلمة مرور المستخدمين التي تمت مصادقتها
9. عندما يُطلب منك، انقر على زر تثبيت نموذج Smart Docs WADL لتثبيت نموذج Smart Docs WADL. في حال تخطّي هذه الخطوة، لن يظهر مثال واجهة برمجة تطبيقات SmartDocuments API على بوابتك.
   ملاحظة: إذا كانت البوابة مرتبطة بتثبيت Apigee Edge for Private Cloud، ولم يكن تثبيت Edge متصلاً بالإنترنت، عليك إجراء ضبط إضافي لوحدة Smart Docs قبل أن تتمكن من استخدام Smart Docs. للحصول على مزيد من المعلومات حول Smart Docs، يُرجى الاطّلاع على http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
10. اضبط إعدادات خادم SMTP. تتطلب Apigee إعداد خادم SMTP لإرسال رسائل البريد الإلكتروني من البوابة.
    لمزيد من المعلومات، يُرجى الاطّلاع على http://apigee.com/docs/developer-services/content/configuring-email.
11. اضبط حساب المشرف من خلال إدخال المعلومات التالية ثم اختَر "حفظ". تجدر الإشارة إلى أنّ Drupal ينشئ بشكلٍ تلقائي مستخدم مشرف باسم "المشرف"، لذلك لا تستخدِم كلمة "admin" كاسم المستخدم.
    إذا تخطّيت هذه الخطوة، يظلّ بإمكانك استخدام Drush لإنشاء مشرف كما هو موضّح أدناه في 4. أنشِئ مستخدمًا مشرفًا.
    1. الاسم الأول واسم العائلة لمطوّر البرامج
    2. اسم مستخدم بوابة المطوّر
    3. كلمة المرور
    4. عنوان البريد الإلكتروني
12. بعد اكتمال التثبيت، اضبط الأذونات في ملف settings.php:
    > chmod 640 /var/www/html/sites/default/settings.php
13. انتقِل إلى الصفحة الرئيسية للبوابة على http://localhost/ أو إلى اسم نظام أسماء النطاقات للبوابة.
14. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف.

4. إنشاء مستخدم مشرف

استخدام Drush لإنشاء مستخدم إداري لتثبيت "خدمات قناة المطوّر". ينشئ Drupal تلقائيًا مستخدم مشرف يُسمّى "المشرف" بشكلٍ تلقائي، لذلك لا تستخدِم كلمة "المشرف" كاسم المستخدم.

1. قرص مضغوط إلى الدليل الافتراضي drupal_root/sites/default. الموقع العادي لدليل الجذر Drupal هو /var/www/html:
   > cd <drupal_root>/sites/default
2. تأكَّد من حصولك على أذونات الكتابة على ملفات Drupal الخاصة:
   > drush vget file_private_path
   
   يُرجع هذا الأمر المسار إلى ملفات Drupal الخاصة، على سبيل المثال:
   file_private_path: 'sites/default/private'
   
   بالتوافق مع /var/www/html/sites/default/private/. استخدِم الأمر التالي للتأكّد من أنّ هذا الدليل قابل للكتابة من قِبل المالك والمجموعة:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. أدخِل الأوامر التالية لإنشاء مستخدم مشرف، مع استبدال الأوامر في “< >” بالقيم:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. سجّل الدخول إلى بوابة المطوّرين بصفتك مشرفًا باستخدام اسم المستخدم وكلمة المرور اللذين تم تحديدهما أعلاه.

5. ضبط كلمة مرور جذر MySQL

في حال تثبيت MySQL كجزء من عملية تثبيت البوابة، يترك النص البرمجي للتثبيت كلمة مرور جذر MySQL مضبوطة على قيمته التلقائية، وتكون فارغة.

استخدِم الأمر التالي لضبط كلمة المرور الجذر:

> mysqladmin -u root password NEWPASSWORD

إذا سبق لك ضبط كلمة المرور الجذر وأردت تغييرها، استخدِم الأمر التالي:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

ويجب أيضًا تعديل كلمة المرور في الملف /var/www/html/sites/default/settings.php.

6. تأكّد من أنّ وحدة مدير التحديثات مفعَّلة.

لتلقّي إشعارات بشأن تحديثات Drupal، تأكَّد من أنّ وحدة إدارة تحديث Drupal مفعَّلة. من قائمة Drupal، اختَر الوحدات وانتقِل للأسفل إلى وحدة مدير التحديثات. إذا لم يكن مفعَّلاً، عليك تفعيله.

وبعد تفعيل الميزة، يمكنك الاطّلاع على التحديثات المتاحة باستخدام عنصر القائمة التقارير > التحديثات المتوفّرة. يمكنك أيضًا استخدام أمر Drush التالي:

> drush pm-info update

يمكنك استخدام عنصر القائمة التقارير > التحديثات المتاحة > الإعدادات لضبط الوحدة لإرسال رسالة إلكترونية إليك عند توفّر التحديثات وضبط معدل تكرار البحث عن التحديثات.

7. اختياري - النشر على خادم إنتاج

إذا كنت تنشر البوابة على خادم إنتاج، عليك تنفيذ خطوات أمان إضافية، بما في ذلك:

1. شغِّل النص البرمجي التالي لتأمين تثبيت MySQL:
   > /usr/bin/mysql_secure_installation
   
   يضبط هذا النص البرمجي كلمة المرور الجذر ويمنحك خيار قصر الوصول إلى الجذر على المضيف المحلي فقط وإزالة قواعد بيانات الاختبار والمستخدم المجهول الذي يتم إنشاؤه تلقائيًا. يُنصَح بشدة بتشغيل هذا النص البرمجي لخوادم الإنتاج.
2. يمكنك تفعيل SELinux وإعداده إذا كان ذلك مطلوبًا بموجب سياسات الشركة.

8. اختياري - ضبط محرك البحث Apache Solr

يتم تلقائيًا إيقاف وحدات Drupal التي تتصل بمحرّك البحث Apache Solr عند تثبيت البوابة. تستخدم معظم البوابات محرك بحث Drupal الداخلي، وبالتالي لا تتطلب وحدات Drupal Solr.

إذا قررت استخدام Solr كمحرّك بحث، عليك تثبيت Solr محليًا على خادمك ثم تفعيل وحدات Drupal Solr وإعدادها على البوابة.

لتفعيل وحدات Drupal Solr:

1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
2. اختَر الوحدات في قائمة Drupal.
3. فعِّل وحدة Apache Solr Framework ووحدة Apache Solr Search.
4. احفظ التغييرات.
5. اضبط Solr على النحو الموضّح في https://drupal.org/node/1999280.

9. اختياري - ثبِّت mod_ssl للتوافق مع HTTPS

يستخدم خادم Apache HTTP وحدة mod_ssl لعرض صفحات الويب عبر HTTPS. إذا كنت تريد استخدام HTTPS، استخدِم الأمر التالي لتثبيت mod_ssl.

> yum install mod_ssl

لمزيد من المعلومات حول ضبط البوابة لاستخدام طبقة المقابس الآمنة، يمكنك الاطّلاع على http://apigee.com/docs/developer-services/content/using-ssl-portal.

‫10. اختياري - تثبيت Smart Docs

تتيح لك ميزة "المستندات الذكية" توثيق واجهات برمجة التطبيقات في بوابة "خدمات المطوِّرين" بطريقة تجعل مستندات واجهة برمجة التطبيقات تفاعلية بالكامل. مع ذلك، لاستخدام Smartالمستندات مع البوابة، يجب أولاً تثبيتها على Edge.

• إذا كنت تربط البوابة بأحد تثبيتات Edge Cloud، يكون تطبيق Smart Docs مثبّتًا ولن تحتاج إلى ضبط أي إعدادات إضافية.
• إذا كنت تربط البوابة بتطبيق Edge for Private Cloud لتثبيته، يجب أن تتأكّد من تثبيت تطبيق Smartdocs على Edge. لمزيد من المعلومات حول تثبيت Edge وSmart Docs، يُرجى الاطّلاع على تثبيت Smartالمستندات.

لمزيد من المعلومات حول المستندات الذكية، يُرجى الاطّلاع على استخدام Smart Docs في المستندات لواجهات برمجة التطبيقات.

11. ما الخطوات التالية؟

الخطوات التالية بعد تثبيت بوابة خدمات المطوّرين هي إعداد بوابة الويب وتخصيصها وفقًا لمتطلباتك المحددة. تحتوي المستندات على موقع Apigee الإلكتروني على جميع المعلومات حول إعداد بوابة وتصميمها وإدارتها. يمكنك الوصول إلى المستندات على http://apigee.com/docs/developer-services/content/what-developer-portal.

يدرج الجدول التالي بعض المهام الأكثر شيوعًا التي تنفّذها بعد التثبيت، ويتضمن روابط إلى مستندات Apigee التي يمكنك من خلالها العثور على مزيد من المعلومات:

المهمة	الوصف
تخصيص المظهر	ويحدّد المظهر مظهر البوابة، بما في ذلك الألوان والنمط والجوانب المرئية الأخرى.
تخصيص المظهر	تتضمن الصفحة الرئيسية القائمة الرئيسية ورسالة الترحيب والرأس والتذييل والعنوان.
إضافة حسابات مستخدمين وإدارتها	تتحكّم عملية التسجيل في كيفية تسجيل المطوّرين الجدد لحساب على البوابة. على سبيل المثال، هل يحصل المطوّرون الجدد على إمكانية وصول فوري إلى المنصة أم يجب إثبات هويتهم من قِبل أحد المشرفين. تتحكّم هذه العملية أيضًا في كيفية إشعار مشرف البوابة عند إنشاء حساب جديد.
ضبط البريد الإلكتروني	ترسل البوابة رسائل إلكترونية استجابةً لأحداث معيّنة. على سبيل المثال، عندما يسجّل مطوّر برامج جديد على المنصة وعندما يفقد مطوّر برامج كلمة المرور الخاصة به.
إضافة حسابات مستخدمين وإدارتها	أضِف صفحة "الأحكام والشروط" التي يجب أن يقبلها المطوّرون قبل السماح لهم بالوصول إلى المنصة.
إضافة حسابات مستخدمين وإدارتها	تنفّذ البوابة نموذج تفويض يستند إلى الدور. قبل السماح للمطوّرين بالتسجيل، يُرجى تحديد الأذونات والأدوار التي تستخدمها البوابة.
إضافة مشاركات المدوّنات والمنتدى	وتحتوي البوابة على دعم مضمَّن للمدونات والمنتديات التي تتضمّن سلاسل محادثات. حدِّد الأذونات المطلوبة لعرض المشاركات في المدوّنة والمنتدى وإضافتها وتعديلها وحذفها.
التأكد من عمل نسخ احتياطية لقاعدة البيانات	تأكد من أنك تقوم بالنسخ الاحتياطي لقاعدة بيانات Drupal. ونظرًا لاختلاف كل عملية تثبيت، يعود إليك تحديد أفضل طريقة للاحتفاظ بنسخة احتياطية من قاعدة البيانات.
إعداد اسم مضيف	في حال عدم إعداد اسم مضيف في خادم نظام أسماء النطاقات، يمكنك في أي وقت الوصول إلى الموقع الإلكتروني من خلال عنوان IP الخاص بالخادم. إذا كنت تريد استخدام اسم مضيف، يمكنك ضبط نظام أسماء النطاقات للخادم، والذي يُفترض أن يعمل بشكل صحيح بدون أي إعدادات أخرى في الإعداد الأساسي. في حال إعداد جهاز لموازنة الحمل أو إذا كنت تحصل على عناوين URL غير صحيحة على موقعك الإلكتروني لسبب آخر، يمكنك ضبط $base_url في ملف settings.php الخاص ببوابة Dev، والذي يتوفّر تلقائيًا في الدليل /var/www/html/sites/default.