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

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

في ما يلي متطلبات الأجهزة والبرامج اللازمة للتثبيت.

متطلبات قاعدة بيانات MySQL

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

إذا أردت تثبيت خادم MySQL على نظام منفصل، يجب أن تكون قد ثبّت خادم MySQL على ذلك النظام قبل بدء تشغيل أداة تثبيت خدمات قناة المطوّرين. يجب أن تكون قد ثبّت الإصدار 5.0.15 من MySQL أو إصدارًا أحدث.

يتطلّب برنامج تثبيت "خدمات قناة المطوّرين" أن يحتوي خادم MySQL على قاعدة بيانات تتضمّن مخطط قاعدة بيانات فارغًا. يطلب منك برنامج تثبيت Developer Channel Services اسم مضيف قاعدة البيانات واسم قاعدة البيانات ومستخدم قاعدة البيانات. بعد ذلك، يتصل برنامج التثبيت بقاعدة البيانات لإنشاء جداول قاعدة البيانات والبيانات التلقائية.

يستخدم مستخدم قاعدة البيانات "خدمات قناة المطوّر" للاتصال بقاعدة البيانات، ويجب أن يكون لديه الامتيازات التالية: SELECT وINSERT وUPDATE وDELETE وCREATE وDROP وINDEX وALTER وCREATE TEMPORARY TABLES وLOCK TABLES.

على سبيل المثال، لإنشاء قاعدة بيانات باسم devportal ومستخدم باسم devportal:

1. ثبِّت خادم MySQL على النظام.
2. سجِّل الدخول إلى MySQL كمستخدم جذر باستخدام الأمر:
   > mysql -u root -p
3. أدخِل كلمة المرور الجذر عندما يُطلب منك ذلك.
4. عند ظهور الطلب mysql>، أدخِل ما يلي لإنشاء مستخدم devportal:
   mysql>create user 'devportal'@'localhost' identified by 'devportal';
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. عند ظهور طلب النظام، أنشئ قاعدة بيانات devportal:
   > mysqladmin -u devportal -p create devportal
   
   أدخِل كلمة مرور devportal.
6. سجِّل الدخول إلى MySQL وامنح إذن الوصول إلى devportal من عنوان IP لخادم البوابة:
   mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   حيث portalIP هو عنوان IP لخادم البوابة، و devportalPW هو كلمة مرور المستخدم devportal.
7. عدِّل /etc/my.cnf لضبط bind-address على عنوان IP الخاص بخادم MySQL.
8. أعِد تشغيل MySQL:
   > /etc/init.d/mysqld restart
9. تأكَّد من أنّ المنفذ 3306 مفتوح على خادم MySQL. يستند هذا الإجراء إلى نظام التشغيل الذي تستخدمه. على سبيل المثال، بالنسبة إلى نظام التشغيل Linux، استخدِم الأمر:
   > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

عند تثبيت Developer Channel Services، حدِّد عدم تثبيت خادم MySQL محليًا. سيُطلب منك بعد ذلك إدخال عنوان IP واسم المستخدم واسم قاعدة البيانات لقاعدة البيانات البعيدة.

متطلبات Red Hat Enterprise Linux (RHEL)

يتطلّب نظام التشغيل RHEL متطلبات إضافية بسبب الاشتراك المطلوب للوصول إلى عمليات تنزيل البرامج من Red Hat. يجب أن يكون الخادم قادرًا على الاتصال بالإنترنت لتنزيل حِزم RPM من خلال yum. في حال استخدام RHEL، يجب تسجيل الخادم على شبكة Red Hat Network (RHN) وتسجيله في القناة الاختيارية للخادم.

يتم التحقّق من متطلبات Red Hat أثناء التثبيت، ويطلب منك مثبّت البوابة تسجيل RHEL إذا لم يسبق لك ذلك. إذا كانت لديك بيانات تسجيل دخول إلى Red Hat، يمكنك استخدام الأمر التالي لتسجيل RHEL قبل بدء عملية التثبيت:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

استبدِل my_username وmy_password ببيانات اعتماد Red Hat.

إذا كان لديك إصدار تجريبي من RHEL، يمكنك الحصول على ترخيص تجريبي لمدة 30 يومًا. لمزيد من المعلومات، يُرجى الانتقال إلى https://access.redhat.com/solutions/32790.

متطلبات SMTP

ترسل البوابة البريد تلقائيًا باستخدام دالة mail() في PHP. يحاول PHP إرسال رسالة إلكترونية باستخدام sendmail على النظام المحلي، والذي يمكن ضبطه في ملف php.ini في PHP.

في بيئة التشغيل الفعلي، تتطلّب Apigee ضبط خادم SMTP لإرسال رسائل إلكترونية من البوابة. لذلك، عليك التأكّد من أنّ Drupal يمكنه الوصول إلى المنفذ المطلوب على خادم SMTP. بالنسبة إلى بروتوكول SMTP غير المتوافق مع بروتوكول أمان طبقة النقل (TLS)، يكون رقم المنفذ عادةً 25. بالنسبة إلى بروتوكول SMTP المفعَّل فيه بروتوكول أمان طبقة النقل (TLS)، غالبًا ما يكون المنفذ 465، ولكن يُرجى مراجعة مزوّد خدمة SMTP.

متطلبات إضافية

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

متطلبات بنية النشر

تتضمّن Developer Channel Services واجهة واحدة مع خادم إدارة Apigee من خلال واجهة برمجة تطبيقات REST لتخزين المعلومات حول تطبيقات المستخدم واستردادها. يجب أن تتمكّن "خدمات قنوات المطوّرين" من الاتصال بخادم الإدارة عبر HTTP أو HTTPS، وذلك حسب عملية التثبيت.

المعلومات المطلوبة قبل بدء التثبيت

قبل بدء التثبيت، يجب أن تتوفّر لديك المعلومات التالية:

1. ما هو النظام الأساسي الذي يتم ضبطه: Red Hat أم CentOS؟ إذا كان هذا تثبيتًا لنظام Red Hat، يجب تسجيل الجهاز على شبكة Red Hat لتنزيل حزم RPM.
2. هل تخطّط لتثبيت MySQL على الجهاز المحلي؟ تتطلّب بعض عمليات تثبيت HA أن يكون MySQL على جهاز مختلف عن الجهاز الذي يعرض صفحات الويب الخاصة بالبوابة. وفي هذه الحالة، لا تثبِّت MySQL على جهازك. إذا أردت تثبيتًا بسيطًا مع كل شيء على الجهاز نفسه، يمكنك تثبيت MySQL محليًا.
3. إذا كنت تنوي الوصول إلى خادم MySQL عن بُعد، يجب توفير اسم المضيف والمنفذ واسم قاعدة البيانات واسم المستخدم وكلمة المرور لخادم MySQL البعيد. يجب ضبط خادم MySQL عن بُعد قبل بدء عملية التثبيت.
4. ما هو اسم النطاق المؤهّل بالكامل لخادم الويب؟ (ستتم إضافة هذه المعلومات إلى /etc/hosts.) يجب أن يكون هذا عنوان IP أو اسم مضيف، مثل portalserver.example.com. القيمة التلقائية هي localhost.
5. هل تريد استخدام الإعدادات التلقائية في Apigee لمضيف Apache الافتراضي؟ يتم إنشاء مضيف افتراضي واحد باستخدام اسم المضيف الذي حدّدته أعلاه في الخطوة 7.
6. هناك ثلاث معلومات تسمح لبوابتك بالتواصل مع خادم إدارة Apigee Edge. وهذه المعلومات هي:
   1. عنوان URL لنقطة نهاية Management API في Apigee: سيكون إما اسم مضيف أو عنوان IP. هذه هي نقطة نهاية REST التي يتم إجراء جميع المكالمات إليها لإنشاء التطبيقات وتسجيل المطوّرين للحصول على مفاتيح التطبيقات. نقطة النهاية التلقائية هي https://api.enterprise.apigee.com/v1.
      
      بالنسبة إلى تثبيت Edge for Private Cloud، يكون عنوان URL على النحو التالي:
      http://EdgeIp:8080/v1
      
      أو:
      https://EdgeIp:SSLport/v1
      
      حيث EdgeIp هو عنوان IP لخادم إدارة Edge و SSLport هو منفذ طبقة المقابس الآمنة لواجهة برمجة تطبيقات إدارة Edge. مثلاً، 8443.
   2. اسم مؤسسة Apigee: هناك علاقة بين البوابات ومؤسسات Apigee Edge. يمكنك إعداد المؤسسة التلقائية عند إعداد نقطة نهاية Management API. القيمة التلقائية هي my-org.
   3. اسم المستخدم وكلمة المرور لنقطة نهاية واجهة برمجة التطبيقات الخاصة بالإدارة: يجب أن يُجري أحد المشرفين في مؤسستك الطلبات من البوابة إلى Edge.
      
      اسم المستخدم وكلمة المرور هذان مخصّصان لمشرف في مؤسستك ويجب استخدامهما فقط للاتصال بـ Edge من البوابة. على سبيل المثال، إذا حدّدت بيانات اعتماد مستخدم، وتم حذف هذا المستخدم على Edge، لن تتمكّن البوابة من الاتصال بـ Edge. لذلك، عليك إنشاء مشرف في مؤسستك لهذا الاتصال فقط.
      
      على سبيل المثال:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd