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

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

قبل التثبيت، تأكَّد مما يلي:

• أنك تجري التثبيت على إصدار 64 بت من إصدار متوافق من Red Hat Enterprise Linux أو CentOS أو Oracle. يمكنك الاطّلاع على قائمة الإصدارات المتوافقة هنا.
• تم تثبيت Yum.
• يمكنك نسخ عمليات التثبيت الحالية احتياطيًا. في حال تعديل أي رمز في Drupal Core أو في أي وحدات غير مخصّصة، سيتم استبدال تعديلاتك. ويشمل ذلك أي تغييرات أجريتها على .htaccess على سبيل المثال لا الحصر. ويجب أن تفترض أنّ أيّ موقع آخر خارج الدليل /sites يملكه تطبيق Drupal. ويُستثنى من هذه القاعدة robots.txt، لأنّه إذا كان هذا الملف متوفّرًا في جذر الويب، سيتم حفظه لك. قبل متابعة التثبيت، احتفظ بنسخة احتياطية من دليلك الأساسي على الويب في Drupal بالكامل. الموقع التلقائي للتثبيت هو /var/www/html، ولكن يمكنك تغييره في وقت التثبيت. بعد تنفيذ خطوات التثبيت الموضحة أدناه، يمكنك استعادة تخصيصاتك من النسخة الاحتياطية.

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

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

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

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

2. اختبار الاتصال بخدمة Apigee Edge

اختبِر الاتصال بخادم إدارة Edge من خلال تنفيذ أمر cURL التالي من موجّه الأوامر على خادم المدخل:
> curl -u {EMAIL}:{password} https://{hostname}:8080/v1/organizations/{ORGNAME}

حيث يكون عنوان EMAIL الخاص بالمشرف وEMAIL

احرص على تحديد اسم المضيف ورقم المنفذ الخاصَّين بتثبيت Edge. المنفذ 8080 هو المنفذ التلقائي الذي يستخدمه Edge. "mod : جلدت على السحابة الإلكترونية"، "س"

3. إزالة الإصدارات التي تسبق الإصدار 7.0 من لغة PHP

يتحقق النص البرمجي للتثبيت من توفُّر إصدارات سابقة للإصدار 7.0 من لغة PHP على النظام قبل البدء في التثبيت. في حالة وجود إصدارات ما قبل 7.0 من PHP، يتم عرض رسالة التحذير التالية:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

بالنسبة إلى نظامَي CentOS وRHEL وRHEL، يمكنك إزالة حِزم PHP باستخدام الأمر التالي:

yum remove <package-name>

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

اتّبِع أحد الإجراءات التالية لتثبيت البوابة استنادًا إلى ما إذا كنت تثبِّت على خادم مزوّد باتصال إنترنت أو بدونه.

على خادم متصل بالإنترنت:

لتثبيت "خدمات قناة المطوّر" على خادم متصل بالإنترنت:

1. سجِّل الدخول إلى الخادم كجذر أو مستخدم متميز.
2. أنشئ دليلاً لملفات التثبيت، مثل البوابة.
3. قرص مضغوط إلى دليل البوابة الجديد ونزِّل ملف DeveloperServices_x.y.z.tar إلى دليل خدمات قناة المطوّر، حيث يتوافق x.y.z مع رقم إصدار البوابة.
   
   يمكنك تنزيل ملف من الرابط الذي تم إرساله إليك من خلال Apigee في متصفّح أو عن طريق نسخه ثم إضافته إلى أمر cURL التالي:
   > curl -kOL <paste link here>
4. استخرِج محتوى ملف .tar في "خدمات قناة المطوّر" باستخدام الأمر:
   > tar -xvf <tar file>
5. قرص مضغوط إلى DeveloperServices-4.x.y.z.
6. شغِّل النص البرمجي للتثبيت باستخدام الأمر التالي:
   > ./networked-install.sh
7. استجب للمطالبات.

على خادم غير متصل بالإنترنت:

أولاً، أنشئ نصًا برمجيًّا للتثبيت غير متصل بالشبكة على نظام متصل بالإنترنت:

1. سجّل الدخول إلى نظام باستخدام اتصال الإنترنت كجذر أو كمستخدم متميز.
2. أنشئ دليلاً لملفات التثبيت، مثل portal_tar.
3. قرص مضغوط إلى دليل portal_tar وتنزيل ملف خدمات قناة المطوّر 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 جديد للتثبيت غير المتصل بالشبكة.

1. سجِّل الدخول إلى الخادم كجذر أو مستخدم متميز.
2. أنشئ دليلاً لملفات التثبيت، مثل البوابة.
3. قرص مضغوط إلى دليل بوابة.
4. انسخ ملف .tar.gz الذي أنشأته للتثبيت غير المتصل بالشبكة (في الإجراء أعلاه) إلى دليل .tar.gz.
5. استخرِج محتوى ملف .tar.gz باستخدام الأمر:
   > tar -xvf <tar file>
6. القرص المضغوط إلى الدليل الذي أنشأه الأمر tar.
7. اضبط الأذونات في النص البرمجي install-from-rpm-bundle.sh:
   > chmod 755 install-from-rpm-bundle.sh
8. شغِّل النص البرمجي install-from-rpm-bundle.sh باستخدام الأمر:
   > ./install-from-rpm-bundle.sh
9. استجب للمطالبات.

5. ضبط بوابة المطوّرين

يتم إجراء الكثير من عمليات إعداد البوابة بدون الحاجة إلى تفاعل منك، مثل تثبيت وحدة Drupal وإنشاء المحتوى التلقائي. سيُطلب منك إعداد قاعدة البيانات وضبط نقطة نهاية Edge وإنشاء مستخدم مشرف جديد.

لإعداد بوابة المطوّرين:

1. انتقِل إلى عنوان URL للخادم في متصفّح، مثل:
   http://localhost. أو إذا تم ضبط عنوان IP أو نظام أسماء نطاقات محدَّد، انتقِل إلى http://IP_address أو http://DNS_name.
   
   ستتم إعادة توجيهك إلى صفحة إعداد قاعدة بيانات ملف Apigee الشخصي.
   
   ملاحظة: عادةً ما تكون قد أعددت اسم المضيف وسجّلته في خادم نظام أسماء النطاقات حتى لا تضطر إلى استخدام http://localhost.
2. اضبط الاتصال بقاعدة البيانات. إذا كانت قاعدة البيانات على جهاز بعيد، وسِّع قسم الخيارات المتقدّمة وأدخِل معلومات الاتصال بهذا الجهاز، ثم اختَر حفظ ومتابعة.
3. اضبط الاتصال بنقطة نهاية Apigee من خلال إدخال المعلومات التالية، ثم اختَر Save (حفظ).
   لمزيد من المعلومات عن هذه القيم، يُرجى الاطّلاع على قسم "المعلومات المطلوبة قبل بدء التثبيت" في متطلبات بوابة "خدمات المطوّرين".
   1. Management API للمؤسسات
   2. عنوان URL لنقطة نهاية واجهة برمجة التطبيقات للإدارة
   3. مستخدم مصادق عليه نقطة النهاية
   4. كلمة مرور المستخدمين التي تمت مصادقتها
4. اضبط حساب المشرف من خلال إدخال المعلومات التالية ثم اختَر "حفظ". تجدر الإشارة إلى أنّ Drupal ينشئ بشكلٍ تلقائي مستخدم مشرف باسم "المشرف"، لذلك لا تستخدِم كلمة "admin" كاسم المستخدم.
   إذا تخطّيت هذه الخطوة، يظلّ بإمكانك استخدام Drush لإنشاء مشرف كما هو موضّح أدناه في 4. أنشِئ مستخدمًا مشرفًا.
   1. الاسم الأول واسم العائلة لمطوّر البرامج
   2. اسم مستخدم بوابة المطوّر
   3. كلمة المرور
   4. عنوان البريد الإلكتروني
5. بعد اكتمال التثبيت، اضبط الأذونات في ملف settings.php:
   > chmod 640 /var/www/html/sites/default/settings.php
6. انتقِل إلى الصفحة الرئيسية للبوابة على http://localhost/ أو إلى اسم نظام أسماء النطاقات للبوابة.
7. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف.

6. إنشاء مستخدم مشرف (اختياري)

استخدام 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.