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

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

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

الأجهزة

المتطلبات

نظام التشغيل

تم اختبار تعليمات التثبيت وملفات التثبيت المقدّمة على أنظمة التشغيل الواردة هنا: https://apigee.com/docs/api-services/reference/supported-software.

ذاكرة الوصول العشوائي (RAM)

1 غيغابايت

قرص صلب

10 غيغابايت

واجهة الشبكة

يجب توفُّر اتصال نشط بالإنترنت.

كجزء من عملية التثبيت، تنزِّل أداة التثبيت الموارد من الويب. إذا تم إعداد بيئتك لتوجيه طلبات HTTP وHTTPS الصادرة، يجب ضبط الخادم الوكيل لمعالجة الطلبات المُعاد توجيهها بشكلٍ صحيح والتي قد تحدث أثناء عملية التنزيل.

على سبيل المثال، يعرض طلب إلى https://drupal.org/ رمز حالة HTTP 301 ويعيد التوجيه إلى https://www.drupal.org/.

يجب ضبط الخادم الوكيل لعرض رمز حالة HTTP‏ 200 مع المحتوى المطلوب من عملية إعادة التوجيه.

بالنسبة إلى عمليات تثبيت SAP، إذا تم إعداد بيئتك لتكون خادمًا وكيلاً لطلبات HTTPS الصادرة، يجب أن يكون الخادم الوكيل متوافقًا مع TLSv1.0. لا يتيح إصدار OpenSSL 0.9.8 استخدام TLSv1.1 أو TLSv1.2، بل TLSv1.0 فقط.

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

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

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

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

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

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

  1. ثبِّت خادم MySQL على النظام.
  2. سجِّل الدخول إلى MySQL كمستخدم جذر باستخدام الأمر:
    > mysql -uroot -p
  3. أدخِل كلمة مرور الجذر عندما يُطلب منك ذلك.
  4. في رسالة طلب mysql>، أدخِل ما يلي لإنشاء مستخدم devportal:
    mysql>إنشاء مستخدم 'devportal'@'localhost' تم تحديده بواسطة 'devportal';
    mysql> منح جميع الامتيازات على *.* to 'devportal'@'localhost';
    mysql> flush features;
    إنهاء
  5. في رسالة مطالبة النظام، أنشِئ قاعدة بيانات devportal:
    > mysqladmin -u devportal -p create devportal

    أدخِل كلمة مرور devبوابة.
  6. سجِّل الدخول إلى MySQL وامنح إذن الوصول إلى devportal من عنوان IP لخدمة البوابة الخادم:
    mysql> GRANT ALL ON devportal.* إلى devportal@'portalIP' تم تحديده من خلال 'devportalPW';

    حيث يكون portalIP هو عنوان IP لخادم البوابة، و devportalPW هي كلمة مرور مستخدم devportal.
  7. عدِّل ملف /etc/my.cnf لضبط bind-address على عنوان IP لخادم MySQL.
  8. أعِد تشغيل MySQL:
    > /etc/init.d/mysqld إعادة تشغيل
  9. تأكَّد من فتح المنفذ 3306 على خادم MySQL. تستند هذه العملية إلى نظام التشغيل الذي تستخدمه. على سبيل المثال، في نظام التشغيل Linux، استخدِم الأمر:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j Accept

عند تثبيت "خدمات قناة المطوّرين"، حدِّد عدم تثبيت خادم 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.

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

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

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

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

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

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

  1. ما هو النظام الأساسي الذي يتم ضبطه: Red Hat أو CentOS؟ إذا كان هذا تثبيتًا لنظام التشغيل Red Hat، يجب تسجيل الجهاز على Red Hat Network لتنزيل حِزم RPM.
  2. هل تخطّط لتثبيت MySQL على الجهاز المحلي؟ تتطلّب بعض عمليات تثبيت ميزة "التوفّر العالي" أن يكون MySQL على جهاز مختلف عن الجهاز الذي يستضيف صفحات الويب في البوابة. في هذه الحالة، لا تثبِّت MySQL محليًا. إذا كنت تريد إجراء عملية تثبيت بسيطة باستخدام كل العناصر على الجهاز نفسه، يمكنك تثبيت MySQL على الجهاز.
  3. إذا كنت تريد الوصول إلى خادم MySQL عن بُعد، يجب إدخال اسم المضيف والمنفذ واسم قاعدة البيانات واسم المستخدم وكلمة مرور خادم MySQL عن بُعد. يجب أن يكون خادم MySQL البعيد قد تم ضبطه قبل بدء عملية التثبيت.
  4. ما هو اسم النطاق المؤهّل بالكامل لخادم الويب؟ (ستتم إضافة هذه المعلومات إلى /etc/hosts.) يجب أن يكون هذا العنوان عنوان IP أو اسم مضيف، مثل portalserver.example.com. القيمة التلقائية هي localhost.
  5. هل تريد استخدام الإعدادات التلقائية في Apigee لمضيف Apache الافتراضي؟ يتم إنشاء مضيف افتراضي واحد باستخدام اسم المضيف الذي حدّدته أعلاه في الخطوة 7.
  6. هناك ثلاث معلومات تسمح لبوابتك بالتواصل مع خادم إدارة Apigee Edge. في ما يلي هذه المعلومات:
    1. عنوان URL لنقطة نهاية واجهة برمجة التطبيقات Apigee Management API: سيكون هذا إما اسم مضيف أو عنوان 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، لن تتمكّن البوابة من الاتصال بـ Edge بعد ذلك. لذلك، يمكنك إنشاء مشرف في مؤسستك لهذا الربط فقط.

      على سبيل المثال:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd