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

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

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

الأجهزة

المتطلبات

نظام التشغيل

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

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

1 غيغابايت

القرص الثابت

10 غيغابايت

واجهة الشبكة

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

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

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

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

بالنسبة إلى عمليات تثبيت SAP، إذا تم إعداد البيئة الخاصة بك على طلبات HTTPS الصادرة من الخادم الوكيل، يجب أن يتوافق الخادم الوكيل مع الإصدار 1.0 من بروتوكول أمان طبقة النقل (TLS). لا يتوافق الإصدار 0.9.8 من OpenSSL مع الإصدار 1.1 من بروتوكول أمان طبقة النقل (TLS) أو الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS)، بل يتوافق مع الإصدار 1.0 من بروتوكول أمان طبقة النقل (TLS) فقط.

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

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

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

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

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

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

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

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

    حيث يكون portalIP هو عنوان IP لخادم البوابة، وportalIP هي كلمة المرور لمستخدم بوابة الويب.
  7. قم بتعديل /etc/my.cnf لتعيين عنوان الربط لعنوان 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 Server محليًا. سيُطلب منك بعد ذلك إدخال عنوان IP واسم المستخدم واسم قاعدة البيانات لقاعدة البيانات البعيدة.

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

تفرض RHEL متطلبات إضافية بسبب الحاجة إلى الاشتراك للوصول إلى عمليات تنزيل البرامج من Red Hat. يجب أن يكون الخادم قادرًا على الاتصال بالإنترنت لتنزيل RPMs عبر 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 لتنزيل العائد لكل ألف ظهور.
  2. هل تخطط لتثبيت MySQL على الجهاز المحلي؟ تتطلب بعض عمليات تثبيت HA أن يكون MySQL على جهاز مختلف عن الجهاز الذي يعرض صفحات ويب البوابة. وفي هذه الحالة، لا تثبِّت MySQL محليًا. إذا أردت إجراء عملية تثبيت بسيطة تتضمّن كل العناصر على الجهاز نفسه، عليك تثبيت MySQL على الجهاز.
  3. إذا كنت تريد الوصول إلى خادم MySQL عن بُعد، اسم المضيف والمنفذ واسم قاعدة البيانات واسم المستخدم وكلمة المرور لخادم MySQL البعيد. من المُفترَض أن يكون خادم MySQL البعيد مُعدًّا من قبل قبل بدء التثبيت.
  4. ما اسم النطاق المؤهل بالكامل لخادم الويب؟ (ستتم إضافة هذه المعلومات إلى /etc/hosts). يجب أن يكون هذا عنوان IP أو اسم مضيف، مثل portalserver.example.com، والقيمة التلقائية هي portalserver.example.com.
  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 الذي يكون هو منفذ طبقة المقابس الآمنة (SSL) لإدارة Edge. مثلاً، 8443.
    2. اسم مؤسسة Apigee: هناك علاقة بين البوابات ومؤسسات Apigee Edge. يمكنك إعداد المؤسسة التلقائية عند ضبط نقطة نهاية Management API. القيمة التلقائية هي my-org.
    3. اسم المستخدم وكلمة المرور لنقطة نهاية واجهة برمجة التطبيقات للإدارة: يجب أن يُجري مشرف في مؤسستك طلبات البيانات من البوابة إلى Edge.

      اسم المستخدم/كلمة المرور هذا تابعان لمشرف في مؤسستك ولا يجب استخدامهما إلا للاتصال بشبكة Edge من البوابة. على سبيل المثال، إذا حددت بيانات اعتماد مستخدم، وتم حذف هذا المستخدم مطلقًا على Edge، لن تتمكن البوابة من الاتصال بخادم Edge بعد ذلك. لذلك، يمكنك إنشاء مشرف في مؤسستك لإجراء عملية الربط هذه فقط.

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