تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

Edge for Private Cloud، الإصدار 4.17.05

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

عليك تثبيت Postgres قبل تثبيت البوابة. يمكنك تثبيت Postgres كجزء من تثبيت Edge، أو تثبيت Postgres مستقل لاستخدامه من خلال البوابة.
- في حال تثبيت Postgres بشكل مستقل، يمكن أن يكون على نفس عقدة البوابة.
- إذا كنت تتصل بخادم Postgres المثبَّت كجزء من Edge، وتم ضبط Postgres في الوضع الرئيسي/الاحتياطي، حدِّد عنوان IP لخادم Postgres الرئيسي.
يتم إجراء عملية التثبيت على الإصدار 64 بت من إصدار متوافق من Red Hat Enterprise Linux أو CentOS أو Oracle. راجِع قائمة الإصدارات المتوافقة على البرامج المتوافقة والإصدارات المتوافقة.
تم تثبيت تطبيق Yum.

نظرة عامة حول عملية التثبيت

بعد تثبيت أداة apigee-setup على Edge، على عقدة، استخدِم تلك لتثبيت البوابة على العقدة. تكون أداة apigee-setup على الشكل التالي:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

مرِّر ملف تهيئة إلى الأداة المساعدة apigee-setup التي تحتوي على العنصر المعلومات حول التثبيت. إذا كان ملف الإعداد يفتقد أي عناصر مطلوبة وهي عملية apigee-setup ستطلب منك الأداة إدخاله في سطر الأوامر.

الشرط الوحيد هو أن يكون ملف التهيئة متاحًا أو قابلاً للقراءة بواسطة "apigee" المستخدم.

على سبيل المثال، استخدِم الأمر التالي لتثبيت البوابة:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

اطّلِع على تثبيت أداة إعداد apigee-setup في Edge للاطّلاع على مزيد من المعلومات.

إنشاء ملف إعداد

يظهر أدناه مثال على ملف إعداد صامت لتثبيت بوابة. تعديل هذا الملف حسب ما يلزم لتهيئتك. استخدِم الخيار -f لتفعيل setup.sh لتضمين هذا الملف.

ملاحظة: لا تضبط DEVPORTAL_ADMIN_USERNAME=admin. تشير رسالة الأشكال البيانية يتم إنشاء حساب مستخدم واحد (admin) تلقائيًا. وفي حال تحديدها، سيتم عرض رسالة خطأ. يطلب منك ضبط اسم مستخدم مختلف.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres. 
PG_NAME=devportal 

# Specify the Postgres admin credentials. 
# The portal connects to Postgres by using the 'apigee' user. 
# If you changed the Postgres password from the default of 'postgres' 
# then set PG_PWD accordingly. 
# If connecting to a Postgres node installed with Edge, 
# contact the Edge sys admin to get these credentials. 
PG_USER=apigee 
PG_PWD=postgres 

# The IP address of the Postgres server. 
# If it is installed on the same node as the portal, specify that IP. 
# If connecting to a remote Postgres server,specify its IP address. 
PG_HOST=$IP1 

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# You must configure the SMTP server used by the portal. 
# The properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. اختبار الاتصال بـ Apigee Edge

اختبر اتصالك بخادم إدارة Edge من خلال تنفيذ أمر cURL التالي من موجِّه أوامر على خادم المدخل:

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

أو:

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/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"
}

2. إزالة الإصدارات السابقة على 7.0 للغة PHP

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

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

قم بإزالة حزم PHP باستخدام الأمر التالي:

yum remove <package-name>

3- تثبيت Postgres

تتطلب البوابة تثبيت Postgres قبل أن تتمكّن من تثبيتها. يمكنك تنفيذ إجراء مما يلي: تثبيت Postgres كجزء من تثبيت Edge، أو تثبيت Postgres المستقل لاستخدامه البوابة.

إذا كنت تتصل بخادم Postgres المثبَّت كجزء من Edge، وتم ضبط Postgres في وضع "الخادم الرئيسي/الخادم الاحتياطي"، حدِّد عنوان IP لخادم Postgres الرئيسي.
في حال تثبيت Postgres بشكل مستقل، يمكن أن يكون على نفس عقدة البوابة.

للحصول على معلومات حول تثبيت Postgres كجزء من تثبيت Edge، راجِع تثبيت مكونات Edge على عقدة.

لتثبيت Postgres بشكل مستقل:

تثبيت الأداة المساعدة apigee-setup على Edge على العقدة باستخدام إجراءً عبر الإنترنت أو غير متصل بالإنترنت. اطّلِع على تثبيت أداة إعداد apigee في Edge للحصول على المزيد من المعلومات.
أنشئ ملف إعداد لـ Postgres، كما هو موضّح أدناه:

# يجب التحويل إلى عنوان IP أو نظام أسماء النطاقات اسم المضيف - ليس على 127.0.0.1 أو المضيف المحلي.
HOSTIP=$(اسم المضيف -i)

# المجموعة ومنطقة Postgres. استخدِم القيم التلقائية الموضَّحة أدناه.
MP_POD=gateway
Region=dc-1

# عيِّن كلمة مرور Postgres. القيمة التلقائية هي postgres.
PG_PWD=postgres
في موجِّه الأوامر، شغِّل النص البرمجي للإعداد لتثبيت Postgres:
. > /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile

يحدد الخيار "-p pdb" خيار تثبيت Postgre.

يجب أن يكون بإمكان مستخدم "apigee" الوصول إلى ملف الإعدادات أو قراءته.

4. تثبيت البوابة

لتثبيت البوابة:

ثبِّت الأداة apigee-setup في Edge على العقدة باستخدام الإنترنت أو إجراء غير مرتبط بالإنترنت. راجع تثبيت أداة Edge apigee-setup للحصول على أخرى.
تأكَّد من تثبيت Postgres، إما بشكل مستقل أو كجزء من عملية تثبيت Edge.
في موجِّه الأوامر، شغِّل النص البرمجي للإعداد:
> /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

يحدد خيار "-p dp" كيفية تثبيت البوابة.

يجب أن يكون ملف الإعداد قابلاً للوصول أو القراءة بواسطة "apigee" المستخدم.
انتقِل إلى الصفحة الرئيسية للبوابة على الرابط http://localhost:8079 أو إلى اسم نظام أسماء النطاقات لبوابتك.
سجِّل الدخول إلى البوابة باستخدام بيانات اعتماد المشرف التي ضبطتها في ملف الإعدادات .

5- تأكَّد من أنّ وحدة "مدير التحديثات" مفعّل

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

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

> drush pm-info update

عليك تنفيذ هذا الأمر من الدليل الجذري للموقع الإلكتروني. يتم تثبيت "بوابة المطوّرين" تلقائيًا على ‎/opt/apigee/apigee-drupal/wwwroot. ولذلك، يجب أولاً تغيير الدليل إلى /opt/apigee/apigee-drupal/wwwroot قبل تشغيل الأمر. إذا لم تقم بتثبيت البوابة في الدليل الافتراضي، فقم بالتغيير إلى دليل التثبيت.

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

6- ضبط محرك البحث Apache Solr (اختياري)

يتم تلقائيًا إيقاف وحدات Drupal التي تتصل بمحرك بحث Apache Solr في حال تقوم بتثبيت البوابة. تستخدم معظم البوابات محرك البحث الداخلي Drupal، وبالتالي لا وحدات Drupal Solr.

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

لتفعيل وحدات Drupal Solr:

سجِّل الدخول إلى البوابة كمستخدم لديه امتيازات المشرف أو امتياز إنشاء المحتوى.
اختَر الوحدات في قائمة Drupal.
فعِّل وحدة إطار عمل Apache Solr ووحدة Apache Solr Search.
احفظ التغييرات.
يمكنك ضبط إعدادات Solr كما هو موضّح في https://drupal.org/node/1999280.

7. تثبيت Smart Docs (اختياري)

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

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

عليك أيضًا تفعيل Smart Docs على البوابة. لمزيد من المعلومات عن SmartDocs، يُرجى الاطّلاع على مقالة استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.

8. ضبط وحدة تحديث JQuery لعمليات التثبيت التي لا تستخدم الإنترنت (اختياري)

في حال تثبيت وحدة تحديث JQuery واستخدامها في عملية تثبيت غير متصلة بالإنترنت، يجب عليك إجراء ما يلي: تهيئة الوحدة لاستخدام الإصدار المحلي من JQuery. إذا قمت بتهيئة الوحدة لاستخدام شبكة توصيل محتوى (CDN) بالنسبة إلى التثبيت غير المتصل بالإنترنت، سيحاول الوصول إلى شبكة توصيل المحتوى (CDN) والتسبب في تأخير الصفحة. قيد التحميل. لمزيد من المعلومات حول وحدة "تحديث JQuery"، يُرجى الاطّلاع على https://www.drupal.org/project/jquery_update.

لإعداد وحدة تحديث JQuery لاستخدام الإصدار المحلي من JQuery:

سجِّل الدخول إلى البوابة كمستخدم لديه امتيازات المشرف أو امتياز إنشاء المحتوى.
حدد الإعداد > التطوير > تعديل JQuery في قائمة Drupal.
انقر على الأداء في شريط التنقّل الأيمن.
في القائمة المنسدلة JQuery وJQuery UI CDN، اختَر بلا.
انقر على حفظ الإعداد.

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

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

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

المهمة	الوصف
يمكن تخصيص المظهر	يحدد المظهر مظهر البوابة، بما في ذلك الألوان والتصميمات وغيرها الجوانب المرئية.
تخصيص المظهر	تتضمن الصفحة الرئيسية القائمة الرئيسية ورسالة الترحيب والرأس والتذييل والعنوان.
إضافة إدارة حسابات المستخدمين	تتحكم عملية التسجيل في كيفية تسجيل المطورين الجدد لحساب على البوابة. على سبيل المثال، هل يحصل المطوّرون الجُدد على إمكانية وصول فوري إلى البوابة، أم هل يجب التحقق من صحتها من قِبل المشرف. تتحكم هذه العملية أيضًا في كيفية عمل البوابة يتم إعلام المشرف عند إنشاء حساب جديد.
التهيئة عنوان البريد الإلكتروني	ترسل البوابة رسائل إلكترونية ردًا على أحداث معيّنة. على سبيل المثال، عندما تكون هناك يسجّل المطوّر على البوابة وعندما يفقد المطوّر كلمة المرور.
إضافة إدارة حسابات المستخدمين	أضِف صفحة "الأحكام والشروط" التي يجب أن يقبلها المطوّرون قبل السماح لهم بالوصول إلى البوابة.
إضافة حسابات المستخدمين وإدارتها	تنفِّذ البوابة نموذج تفويض على أساس الدور. قبل السماح للمطورين السجل، وتحديد الأذونات والأدوار التي تستخدمها البوابة.
يمكنك إضافة مدونة مشاركات المنتدى	تتضمّن البوابة ميزات مدمجة تتيح إنشاء مدوّنات ومنتديات تتضمّن سلاسل محادثات. تحديد الأذونات مطلوب لعرض مشاركات المدونة والمنتدى وإضافتها وتعديلها وحذفها.
التأكد من عمل نسخ احتياطية لقاعدة البيانات	تأكَّد من الاحتفاظ بنسخة احتياطية من قاعدة بيانات Drupal. لاحظ أنه نظرًا لأن كل من بين ميزات التثبيت المختلفة، فإن الأمر متروك لك لتحديد أفضل طريقة لإجراء نسخ احتياطي قاعدة البيانات. ملاحظة: لا تتوافق وحدة "الاحتفاظ بنسخة احتياطية" و"نقل البيانات" مع Postgres. لقواعد البيانات. راجِع أيضًا كيفية إجراء عملية الاحتفاظ بنسخة احتياطية.
إعداد اسم مضيف	إذا لم يتم إعداد اسم مضيف في خادم نظام أسماء النطاقات، فيمكنك دائمًا الوصول إلى الموقع من خلال عنوان IP للخادم. إذا كنت تريد استخدام اسم مضيف، يمكنك ضبط نظام أسماء النطاقات للخدمة، ومن المفترض أن يعمل بشكل صحيح بدون أي إعدادات أخرى في الإعداد الأساسي. إذا أعددت جهاز موازنة الحمل أو تظهر لك عناوين URL غير صحيحة على موقعك الإلكتروني لبعض الوقت السبب الآخر، يمكنك ضبط $base_url في ملف settings.php بوابة مطوّري البرامج، والتي تقع افتراضيًا في دليل /opt/apigee/apigee-drupal/wwwroot/sites/default.
التطوير المخصّص	يمكنك أيضًا تعزيز إمكانات البوابة باستخدام رمز مخصّص خارج الموضوع. لإجراء ذلك، يجب إنشاء وحدة Drupal الخاصة بك كما هو موضّح في وحدة Drupal التطوير، ووضع الوحدة في `/sites/all/modules` الدليل.