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

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

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

قبل مواصلة عملية التثبيت، عليك إنشاء نسخة احتياطية من جذر الويب الخاص بمنصة Drupal بالكامل. الدليل. موقع التثبيت التلقائي هو /var/www/html، ولكن ربما تكون قد غيّرته. في وقت التثبيت بعد تنفيذ خطوات التثبيت الموضحة أدناه، يمكنك استعادة عمليات التخصيص من النسخة الاحتياطية.

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

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

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

2. التأكّد من توافق نظامك مع النظام المتطلبات

قبل تثبيت البوابة، يجب أن يستوفي خادمك المتطلبات التالية:

1. تأكد من أنك تجري التثبيت على إصدار 64 بت من إصدار متوافق من Red Hat Enterprise Linux أو CentOS أو Oracle. يمكنك الاطّلاع هنا على قائمة بالإصدارات المتوافقة.
2. تأكَّد من تثبيت Yum.
3. (بالنسبة إلى التثبيت على خادم بدون اتصال بالإنترنت) يجب عليك تقوم أولاً بتنزيل جميع الملفات اللازمة على خادم متصل بالإنترنت في ملف .tar.gz. ثم تنسخ ملف .tar.gz هذا إلى الخادم بدون الاتصال بالإنترنت إجراء التثبيت.
   1. سجل الدخول إلى خادم متصل بالإنترنت كجذر أو كمستخدم مميز.
   2. أنشِئ دليلاً لملفات التثبيت، مثل portal_tar.
   3. قرص مضغوط إلى الدليل الجديد وتنزيل خدمات قنوات المطوّرين DeveloperServices_x.y.z.tar ، حيث يتجاوب x.y.z مع رقم إصدار البوابة.
   4. استخرِج محتوى ملف .tar لخدمات قناة المطوّرين باستخدام الأمر:
      &gt; tar -xvf <tar file&gt;
   5. قرص مضغوط إلى DeveloperServices-4.x.y.z.
   6. أنشئ ملف البوابة .tar.gz باستخدام الأمر:
      &gt; ./non-networked-install.sh
      
      يعمل ذلك الأمر على تنزيل جميع الملفات اللازمة وحفظها في ملف .tar.gz واحد. إِنْتَ ثم انسخ ملف .tar.gz هذا إلى خادمك الذي لا يتضمن اتصالاً بالإنترنت لإكمال التثبيت.
4. اختبر اتصالك بخادم إدارة Edge من خلال تنفيذ أمر cURL التالي من موجِّه أوامر على خادم البوابة:
   &gt; ضفيرة -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   حيث يقع عنوان البريد الإلكتروني EMAIL وpassword في عنوان وكلمة مرور مشرف ORGNAME.
   
   تأكَّد من تحديد اسم المضيف ورقم المنفذ الخاص بتثبيت Edge. المنفذ 8080 هو المنفذ التلقائي الذي تستخدمه شبكة Edge. إذا كنت تتصل بمؤسسة في السحابة، سيكون عنوان URL للطلب هو:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   في حال نجاح هذا الأمر، سيعرض هذا الأمر ردًا مشابهًا لما يلي:
   {
   "CREATEAt" : 1348689232699،
   "CREATEBy" : "USERNAME"،
   &quot;displayName&quot; : "cg",
   "البيئات" : [ "test", "prod" ],
   "lastModifiedAt" : 1348689232699،
   "lastEDITBy" : "foo@bar.com",
   "الاسم" : "cg",
   "الخصائص" : {
   "الموقع" : [ ]
   },
   "النوع" : "تجربة"
   }

3- تثبيت المطوِّر خدمات القناة باستخدام النص البرمجي للتثبيت المبرمَج

استخدِم الإجراء التالي لتثبيت البوابة باستخدام النص البرمجي للتثبيت الآلي. هذا النمط مع الخوادم التي بها اتصال خارجي بالإنترنت أو بدونه.

1. سجل الدخول إلى الخادم كجذر أو كمستخدم مميز.
2. أنشِئ دليلاً لملفات التثبيت، مثل البوابة.
3. على خادم متصل بالإنترنت:
   1. قرص مضغوط إلى البوابة الجديدة الدليل وتنزيل خدمات قنوات المطوّرين DeveloperServices_x.y.z.tar ، حيث يتوافق x.y.z مع رقم إصدار البوابة.
      
      يمكنك تنزيل ملف من الرابط الذي تم إرساله إليك من خلال Apigee في متصفّح أو من خلال نسخه. ثم إضافته إلى أمر cURL التالي:
      &gt; curl -kOL <لصق الرابط here&gt;
   2. استخرِج محتوى ملف .tar لخدمات قناة المطوّرين باستخدام الأمر:
      &gt; tar -xvf <tar file&gt;
   3. قرص مضغوط إلى DeveloperServices-4.x.y.z.
   4. شغِّل تثبيت النص البرمجي باستخدام الأمر التالي:
      &gt; ./networked-install.sh
4. على خادم بلا اتصال بالإنترنت:
   1. انسخ ملف .tar.gz الذي أنشأته أعلاه في القسم 2. التأكّد من توافق نظامك متطلبات النظام.
   2. استخرِج محتوى ملف .tar.gz باستخدام الأمر:
      &gt; tar -xvf <tar file&gt;
   3. قرص مضغوط إلى الدليل الذي أنشأه أمر tar.
   4. اضبط الأذونات على النص البرمجي install-from-rpm-bundle.sh:
      . > أمر chmod 755 install-from-rpm-bundle.sh
   5. شغِّل النص البرمجي install-from-rpm-bundle.sh في باستخدام الأمر:
      > ./install-from-rpm-bundle.sh
5. أجِب عن الطلبات.
6. بعد اكتمال التثبيت، انتقِل إلى عنوان URL الخاص بالخادم في متصفّح، مثل كـ:
   http://localhost. أو إذا كان لديك عنوان IP محدد أو نظام أسماء نطاقات محدَّد يمكنك الانتقال إلى http://IP_address أو http://DNS_name.
   
   ستتم إعادة توجيهك إلى صفحة إعداد قاعدة بيانات الملف الشخصي في Apigee.
   
   ملاحظة: يجب عادةً ضبط اسم المضيف وتسجيله. مع خادم نظام أسماء النطاقات حتى لا تضطر إلى استخدام http://localhost.
7. اضبط الاتصال بـ MySQL. إذا كان MySQL على جهاز بعيد، عليك توسيع الخيارات المتقدمة وأدخل معلومات الاتصال بهذا الجهاز، ثم انقر على حفظ ومتابعة.
8. ضبط الاتصال بنقطة نهاية Apigee من خلال إدخال المعلومات التالية ثم انقر على حفظ:
   للمزيد من المعلومات حول هذه القيم، يمكنك الاطّلاع على "المعلومات المطلوبة قبل بدء التثبيت" على بوابة خدمات المطورين المتطلبات.
   1. بوابة مطوّري البرامج للمؤسسة
   2. عنوان URL لنقطة نهاية بوابة مطوّري البرامج
   3. مستخدم تمت المصادقة عليه لنقطة النهاية
   4. "المستخدمون الذين تمت مصادقتهم" كلمة المرور
9. اختَر الزر تثبيت نموذج Smart Docs WADL عندما يُطلب منك ذلك لتثبيته. نموذج Smart Docs WADL. إذا تخطيت هذه الخطوة، فلن تظهر واجهة برمجة التطبيقات Smartالمستندات API كمثال تظهر على البوابة.
   ملاحظة: إذا كانت البوابة تتصل بتثبيت Apigee Edge for Private Cloud، وأنّ تثبيت Edge لا يتضمّن اتصالاً خارجيًا بالإنترنت، لذا يجب تنفيذ تهيئة إضافية لوحدة Smart Docs قبل أن تتمكن من استخدام هذا التطبيق. لمزيد من المعلومات، معلومات حول Smart Docs، يمكنك الاطّلاع على http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
10. اضبط إعدادات خادم SMTP. تتطلب Apigee إعداد خادم SMTP لإرسال رسائل بريد إلكتروني من البوابة.
    لمزيد من المعلومات، يُرجى الاطّلاع على http://apigee.com/docs/developer-services/content/configuring-email.
11. اضبط مستخدم المشرف من خلال إدخال المعلومات التالية، ثم اختَر حفظ. يُرجى العلم أنّ منصة Drupal تنشئ مستخدمًا مشرفًا باسم "المشرف". بشكل تلقائي، لذلك لا تستخدم خيار "المشرف" كـ اسم المستخدم.
    إذا تخطّيت هذه الخطوة، سيظل بإمكانك استخدام تطبيق Drush لإنشاء مشرف كما هو موضَّح أدناه. في 4. أنشئ مستخدم مشرف.
    1. الاسم الأول واسم العائلة للمطوِّر
    2. اسم مستخدم بوابة المطوِّر
    3. كلمة المرور
    4. عنوان البريد الإلكتروني
12. بعد اكتمال التثبيت، اضبط الأذونات في الملف settings.php:
    > أمر chmod 640 /var/www/html/sites/default/settings.php
13. انتقل إلى صفحة البوابة الرئيسية على http://localhost/ أو إلى اسم نظام أسماء النطاقات البوابة.
14. سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف.

4. إنشاء مستخدم مشرف

يمكنك استخدام Drush لإنشاء مستخدم إداري لتثبيت "خدمات قناة المطوِّرين". تنشئ منصة Drupal تلقائيًا مستخدم مشرف باسم "المشرف" بشكل تلقائي، لذلك لا تستخدم خيار "المشرف" باعتباره اسم المستخدم.

1. القرص المضغوط إلى الدليل drupal_root/sites/default. الموقع العادي لجذر Drupal الدليل هو /var/www/html:
   &gt; cd &lt;drupal_root&gt;/sites/default
2. يُرجى التأكّد من امتلاك أذونات الكتابة في ملفات Drupal الخاصة:
   &gt; 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. أدخِل الأوامر التالية لإنشاء مستخدم مشرف، مع استبدال الأوامر في "< >" باستخدام القيم التالية:
   &gt; حث المستخدمين على إنشاء المحتوى <اسم المستخدم> --mail=&quot;&lt;email-address&gt;&quot; --password=&quot;&lt;password&gt;&quot;
   &gt; حذف دور المستخدم-إضافة دور المشرف <اسم المستخدم>
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:
   &gt; /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 وApache Solr البحث.
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المستندات مع البوابة، ينبغي لك أولاً تثبيت Smart Docs على Edge.

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

لمزيد من المعلومات حول Smart Docs، يمكنك الاطّلاع على استخدام Smart Docs للمستندات. API.

11. ماذا بعد ذلك؟

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

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

المهمة	الوصف
يمكن تخصيص المظهر	يحدد المظهر مظهر البوابة، بما في ذلك الألوان والتصميمات وغيرها الجوانب المرئية.
تخصيص المظهر	تتضمن الصفحة الرئيسية القائمة الرئيسية ورسالة الترحيب والرأس والتذييل والعنوان.
إضافة إدارة حسابات المستخدمين	تتحكم عملية التسجيل في كيفية تسجيل المطورين الجدد لحساب على البوابة. على سبيل المثال، هل يحصل المطوّرون الجُدد على إمكانية وصول فوري إلى البوابة، أم هل يجب التحقق من صحتها من قِبل المشرف. تتحكم هذه العملية أيضًا في كيفية عمل البوابة يتم إعلام المشرف عند إنشاء حساب جديد.
التهيئة عنوان البريد الإلكتروني	ترسل البوابة رسائل إلكترونية استجابةً لأحداث معينة. على سبيل المثال، عندما تكون هناك يسجّل المطوّر على البوابة وعندما يفقد المطوّر كلمة المرور.
إضافة إدارة حسابات المستخدمين	إضافة بنود صفحة الشروط التي يجب أن يقبلها المطوّرون قبل السماح لهم الوصول إلى البوابة.
إضافة إدارة حسابات المستخدمين	تنفِّذ البوابة نموذج تفويض على أساس الدور. قبل السماح للمطورين السجل، وتحديد الأذونات والأدوار التي تستخدمها البوابة.
يمكنك إضافة مدونة مشاركات المنتدى	تحتوي البوابة على دعم مضمَّن للمدونات والمنتديات التي تتضمن سلاسل محادثات. تحديد الأذونات مطلوب لعرض مشاركات المدونة والمنتدى وإضافتها وتعديلها وحذفها.
التأكد من عمل نسخ احتياطية لقاعدة البيانات	تأكَّد من إجراء نسخ احتياطي لقاعدة بيانات Drupal. لاحظ أنه نظرًا لأن كل من بين ميزات التثبيت المختلفة، فإن الأمر متروك لك لتحديد أفضل طريقة لإجراء نسخ احتياطي قاعدة البيانات.
إعداد اسم مضيف	إذا لم يتم إعداد اسم مضيف في خادم نظام أسماء النطاقات، فيمكنك دائمًا الوصول إلى الموقع من خلال عنوان IP للخادم. إذا كنت تريد استخدام اسم مضيف، فيمكنك تهيئة نظام أسماء النطاقات على الخادم، والذي ينبغي أن يعمل بشكل صحيح بدون أي تهيئة أخرى على أي إعداد أساسي. إذا أعددت جهاز موازنة الحمل أو تظهر لك عناوين URL غير صحيحة على موقعك الإلكتروني لبعض الوقت السبب الآخر، يمكنك ضبط $base_url في ملف settings.php بوابة مطوّري البرامج، والتي تقع تلقائيًا في صفحة /var/www/html/sites/default الدليل.