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

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

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

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

اتّبِع الخطوات التالية لتثبيت بوابة Developer Channel Services.

1. الحصول على حزمة Developer Channel Services

انتقِل إلى 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 وPASSWORD هما عنوان البريد الإلكتروني وكلمة المرور للمشرف لـ ORGNAME.

تأكَّد من تحديد اسم المضيف ورقم المنفذ الخاصَّين بتثبيت Edge. يُرجى العِلم أنّ المنفذ 8080 هو المنفذ التلقائي الذي يستخدمه Edge. إذا كنت تتصل بمؤسسة في السحابة الإلكترونية، يكون عنوان URL للطلب هو: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

في حال نجاح هذا الأمر، يعرض ردًا مشابهًا لما يلي:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

3- إزالة إصدارات PHP الأقدم من 7.0

يتحقّق نص التثبيت البرمجي من إصدارات PHP السابقة للإصدار 7.0 على النظام قبل بدء التثبيت. إذا كانت هناك إصدارات من PHP أقدم من 7.0، ستظهر رسالة التحذير التالية:

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 وRed Hat Enterprise Linux (RHEL)، يمكنك إزالة حِزم PHP باستخدام الأمر التالي:

yum remove <package-name>

4. تثبيت Developer Channel Services باستخدام نص التثبيت البرمجي الآلي

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

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

لتثبيت Developer Channel Services على خادم متصل بالإنترنت:

1. سجِّل الدخول إلى الخادم كمستخدم جذر أو مستخدم مميّز.
2. أنشئ دليلاً لملفات التثبيت، مثل portal.
3. انتقِل إلى دليل البوابة الجديد ونزِّل ملف Developer Channel Services 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. أنشئ دليلاً لملفات التثبيت، مثل portal.
3. انتقِل إلى دليل portal.
4. انسخ ملف ‎.tar.gz الذي أنشأته للتثبيت بدون اتصال بالشبكة (في الإجراء أعلاه) إلى دليل portal.
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 أو نظام أسماء نطاقات (DNS) محدّد، انتقِل إلى http://IP_address أو http://DNS_name.
   
   ستتم إعادة توجيهك إلى صفحة إعدادات قاعدة بيانات ملف Apigee الشخصي.
   
   ملاحظة: من المفترض أن تكون قد ضبطت اسم مضيف وسجّلته في خادم نظام أسماء النطاقات لكي لا تضطر إلى استخدام http://localhost.
2. اضبط الاتصال بقاعدة البيانات. إذا كانت قاعدة البيانات على جهاز عن بُعد، وسِّع قسم الخيارات المتقدّمة وأدخِل معلومات الاتصال بهذا الجهاز، ثم انقر على حفظ ومتابعة.
3. اضبط الاتصال بنقطة نهاية Apigee من خلال إدخال المعلومات التالية، ثم انقر على حفظ.
   لمزيد من المعلومات حول هذه القيم، يُرجى الاطّلاع على "المعلومات المطلوبة قبل بدء التثبيت" في متطلبات بوابة خدمات المطوّرين.
   1. Management API Org
   2. عنوان URL لنقطة نهاية Management API
   3. مستخدم تمت مصادقته من خلال نقطة النهاية
   4. كلمة مرور المستخدمين الذين تمت مصادقتهم
4. اضبط إعدادات مستخدم المشرف من خلال إدخال المعلومات التالية، ثم انقر على "حفظ". يُرجى العِلم أنّ Drupal ينشئ مستخدمًا مشرفًا باسم "admin" تلقائيًا، لذا لا تستخدِم "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 لإنشاء مستخدم إداري لتثبيت Developer Channel Services. ينشئ Drupal تلقائيًا مستخدمًا مشرفًا باسم "admin"، لذا لا تستخدم "admin" كاسم مستخدم.

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. تأكَّد من تفعيل وحدة &quot;مدير التحديث&quot; (Update manager)

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

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

> drush pm-info update

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

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

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

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

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

By default, the Drupal modules that connect to the Apache Solr search engine are disabled when you install the portal. تستخدم معظم البوابات محرك البحث الداخلي في Drupal، وبالتالي لا تتطلب وحدات Drupal Solr.

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

لتفعيل وحدات Drupal Solr، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى البوابة بصفتك مستخدمًا لديه امتيازات المشرف أو إنشاء المحتوى.
2. اختَر Modules (الوحدات) في قائمة 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. تثبيت SmartDocs (اختياري)

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

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

لمزيد من المعلومات حول SmartDocs، يُرجى الاطّلاع على استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.

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

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

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