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

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

Edge for Private Cloud‏ 4.17.01

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

يمكنك تثبيت 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

راجِع تثبيت الأداة المساعدة Edge apigee-setup لمعرفة مزيد من المعلومات.

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

في ما يلي مثال على ملف الضبط الصامت لتركيب البوابة. عدِّل هذا الملف حسب الحاجة لضبط إعداداتك. استخدِم الخيار -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

بالنسبة إلى CentOS وRHAT Enterprise Linux (RHEL)، أزِل حزم 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، كما هو موضّح أدناه:

# مجموعة الوحدات والمنطقة في 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" تثبيت Postgres.

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

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

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

ثبِّت الأداة apigee-setup في Edge على العقدة باستخدام الإنترنت أو إجراء غير مرتبط بالإنترنت. اطّلِع على تثبيت أداة إعداد apigee في Edge للحصول على المزيد من المعلومات.
تأكَّد من تثبيت Postgres، إما 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. لذلك، عليك أولاً تغيير الدليل إلى ‎/opt/apigee/apigee-drupal قبل تنفيذ الأمر. إذا لم يتم تثبيت البوابة في الدليل التلقائي ، انتقِل إلى دليل التثبيت.

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

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- تثبيت SmartDocs (اختياري)

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

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

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

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

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

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

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