نظرة عامة على تثبيت Edge

الإصدار 4.16.09 من Edge for Private Cloud

يتألف تثبيت Edge العادي من مكوّنات Edge موزّعة على عُقد متعددة. بعد تثبيت Edge على عقدة، يمكنك تثبيت مكوّن واحد أو أكثر من مكوّنات Edge وضبطه على العقدة.

عملية التثبيت

يتألف تثبيت Edge على عقدة من عدة خطوات:

• أوقِف SELinux على العقدة أو اضبطه على وضع السماح. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
• اختَر إعدادات Edge من قائمة المخططات المقترَحة. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. لمزيد من المعلومات، يُرجى الاطّلاع على بُنى التثبيت.
• على كل عقدة في المخطط الذي اخترته، ثبِّت الأداة المساعدة apigee-setup في Edge:
  • نزِّل ملف Edge bootstrap_4.16.09.sh إلى ‎/tmp/bootstrap_4.16.09.sh.
  • ثبِّت أداة Edge apigee-service والتبعيات.
  • ثبِّت أداة Edge apigee-setup والتبعيات.
    
    لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
• استخدِم الأداة المساعدة apigee-setup لتثبيت مكوّن واحد أو أكثر من مكوّنات Edge على كل عُقدة استنادًا إلى المخطط الذي اخترته.
  يُرجى الاطّلاع على تثبيت مكوّنات Edge على عقدة على عقدة.
• في عقدة خادم الإدارة، استخدِم أداة apigee-setup لتثبيت apigee-provision، وهي الأدوات التي تستخدمها لإنشاء مؤسسات Edge وإدارتها.
  لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مؤسسة.

التعامل مع تعذُّر التثبيت

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

ضبط النسخ المتماثل الرئيسي-الاحتياطي في Postgres

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

المستخدمون الذين يمكنهم إجراء التثبيت

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من حِزم RPM والتبعيات. لتثبيت Edge وإلغاء تثبيته وتحديثه، يجب تشغيل أوامر Edge من خلال المستخدم الجذر أو من خلال مستخدم لديه إذن وصول كامل إلى sudo. بالنسبة إلى إذن الوصول الكامل من النوع sudo، يعني ذلك أنّ المستخدم لديه إذن وصول من النوع sudo لتنفيذ العمليات نفسها التي ينفّذها المستخدم الجذر.

يجب أن يكون أي مستخدم يريد تشغيل الأوامر أو النصوص البرمجية التالية إما مستخدمًا جذرًا أو مستخدمًا لديه إذن وصول كامل إلى sudo:

• apigee-service:
  • أوامر apigee-service: install, uninstall, update.
  • أوامر apigee-all: install, uninstall, update.
• النص البرمجي setup.sh لتثبيت مكوّنات Edge (ما لم تكن قد استخدمت "apigee-service install" لتثبيت حِزم RPM المطلوبة. ثم إذن وصول من النوع الجذري أو النوع sudo الكامل إذا لم يكن مطلوبًا.)
• النص البرمجي update.sh لتحديث مكوّنات Edge

بالإضافة إلى ذلك، ينشئ مثبّت Edge مستخدمًا جديدًا على نظامك باسم "apigee". Many Edge commands invoke sudo to run as the "apigee" user.

يجب أن يكون أي مستخدم يريد تشغيل جميع الأوامر الأخرى غير تلك الموضّحة أعلاه مستخدمًا لديه إذن وصول كامل إلى sudo لمستخدم "apigee". وتشمل هذه الطلبات ما يلي:

• أوامر الأداة المساعدة apigee-service، بما في ذلك:
  • أوامر apigee-service، مثل start وstop وrestart وconfigure
  • أوامر apigee-all، مثل start وstop وrestart وconfigure

لضبط مستخدم ليحصل على إذن وصول كامل إلى مستخدم "apigee"، عليك تعديل ملف sudoers لإضافة:

installUser        ALL=(apigee)      NOPASSWD: ALL

حيث يمثّل installUser اسم المستخدم للشخص الذي يعمل مع Edge.

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

عند إنشاء ملف إعداد، يمكنك تغيير مالكه إلى "apigee:apigee" لضمان إمكانية وصول أوامر Edge إليه:

1. أنشئ الملف في محرِّر بصفتك أي مستخدم.
2. غيِّر مالك الملف إلى "apigee:apigee" أو إذا غيّرت المستخدم الذي يشغّل خدمة Edge من المستخدم "apigee"، غيِّر مالك الملف إلى المستخدم الذي يشغّل خدمة Edge.

موقع ملفات إعدادات التثبيت

يجب تمرير ملف إعداد إلى الأداة المساعدة apigee-setup التي تحتوي على معلومات حول تثبيت Edge. الشرط الوحيد في عمليات التثبيت التلقائي هو أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee". على سبيل المثال، ضَع الملف في الدليل /usr/local/var أو /usr/local/share على العقدة وغيِّر ملكيته إلى "apigee:apigee".

جميع المعلومات في ملف الإعداد مطلوبة باستثناء كلمة مرور مشرف نظام Edge. إذا حذفت كلمة المرور، ستطلب منك الأداة المساعدة apigee-setup إدخالها في سطر الأوامر.

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عقدة.

التثبيت باستخدام الإنترنت أو بدونه

لتثبيت Edge على عقدة، يجب أن تتمكّن العقدة من الوصول إلى مستودع Apigee:

• العُقَد التي تتصل بالإنترنت الخارجي
  
  تصل العُقَد التي تتصل بالإنترنت الخارجي إلى مستودع Apigee لتثبيت Edge RPMs والتبعيات.
• العُقد التي لا تتصل بالإنترنت الخارجي
  
  يمكن للعُقد التي لا تتصل بالإنترنت الخارجي الوصول إلى نسخة مطابقة من مستودع Apigee الذي تم إعداده داخليًا. يحتوي هذا المستودع على جميع حِزم Edge RPM، ولكن عليك التأكّد من توفّر جميع التبعيات الأخرى من المستودعات على الشبكة الداخلية.
  
  ملاحظة: لا تستضيف Apigee جميع التبعيات التابعة لجهات خارجية في مستودعاتنا العامة. يجب تنزيل هذه التبعيات وتثبيتها من مستودعات يمكن للجميع الوصول إليها.

حلّ مشاكل التبعيات في تثبيت RPM

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من ملفات RPM، ويمكن أن يكون لكل منها سلسلة خاصة من تبعيات التثبيت. يتم تحديد العديد من هذه التبعيات من خلال مكوّنات تابعة لجهات خارجية خارج نطاق تحكّم Apigee ويمكن أن تتغيّر في أي وقت. لذلك، لا تدرج المستندات رقم الإصدار الصريح لكل تبعية.

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

إعداد مضيف افتراضي

يحدّد المضيف الافتراضي على Edge النطاقات ومنافذ Edge Router التي يتم عرض الخادم الوكيل لواجهة برمجة التطبيقات عليها، وبالتالي عنوان URL الذي تستخدمه التطبيقات للوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات. يحدّد المضيف الافتراضي أيضًا ما إذا كان يتم الوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات باستخدام بروتوكول HTTP أو بروتوكول HTTPS المشفّر.

كجزء من عملية إعداد Edge، عليك إنشاء مؤسسة وبيئة ومضيف افتراضي. يوفّر Edge الأمر setup-org لتسهيل هذه العملية على المستخدمين الجدد.

عند إنشاء المضيف الافتراضي، يجب تحديد المعلومات التالية:

• اسم المضيف الافتراضي الذي تستخدمه للإشارة إليه في الخوادم الوكيلة لواجهة برمجة التطبيقات
• المنفذ على جهاز التوجيه للمضيف الافتراضي. عادةً ما تبدأ هذه المنافذ من 9001 وتزيد بمقدار واحد لكل مضيف افتراضي جديد.
• العنوان البديل للمضيف الخاص بالمضيف الافتراضي. عادةً ما يكون اسم نظام أسماء النطاقات للمضيف الافتراضي.

يقارن Edge Router عنوان المضيف للطلب الوارد بقائمة الأسماء المستعارة المتاحة للمضيف كجزء من تحديد الخادم الوكيل لواجهة برمجة التطبيقات الذي يعالج الطلب. عند تقديم طلب من خلال مضيف افتراضي، حدِّد اسم نطاق يتطابق مع الاسم المستعار للمضيف الافتراضي، أو حدِّد عنوان IP الخاص بجهاز التوجيه ورأس المضيف الذي يحتوي على الاسم المستعار للمضيف.

على سبيل المثال، إذا أنشأت مضيفًا افتراضيًا باسم مستعار myapis.apigee.net على المنفذ 9001، يمكن لطلب cURL إلى واجهة برمجة تطبيقات من خلال هذا المضيف الافتراضي استخدام أحد النماذج التالية:

• إذا كان لديك إدخال في نظام أسماء النطاقات لـ myapis.apigee.net:
  
  curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• إذا لم يكن لديك إدخال في نظام أسماء النطاقات لـ myapis.apigee.net:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
  
  في هذا النموذج، يمكنك تحديد عنوان IP لجهاز التوجيه، وتمرير الاسم البديل للمضيف في عنوان المضيف.
  
  ملاحظة: يضيف الأمر curl ومعظم المتصفحات والعديد من الأدوات المساعدة الأخرى تلقائيًا عنوان المضيف مع النطاق كجزء من الطلب، لذا يمكنك استخدام أمر curl بالصيغة التالية:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

الخيارات المتاحة في حال عدم توفّر إدخال في نظام أسماء النطاقات للمضيف الافتراضي

من بين الخيارات المتاحة عندما لا يكون لديك إدخال في نظام أسماء النطاقات هو ضبط الاسم المستعار للمضيف على عنوان IP الخاص بـ الموجّه ومنفذ المضيف الافتراضي، مثل <routerIP>:port. على سبيل المثال:

192.168.1.31:9001

بعد ذلك، يمكنك إنشاء أمر curl في النموذج أدناه:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

يُفضَّل هذا الخيار لأنّه يعمل بشكل جيد مع واجهة مستخدم Edge.

إذا كان لديك عدة أجهزة توجيه، أضِف اسمًا بديلاً للمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي.

بدلاً من ذلك، يمكنك ضبط الاسم المستعار للمضيف على قيمة، مثل temp.hostalias.com. بعد ذلك، عليك تمرير عنوان المضيف في كل طلب:

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path}  -H 'host: temp.hostalias.com'

أو يمكنك إضافة الاسم المستعار للمضيف إلى ملف مضيف /etc/hosts. على سبيل المثال، أضِف هذا السطر إلى /etc/hosts:

192.168.1.31   temp.hostalias.com

بعد ذلك، يمكنك تقديم طلب كما لو كان لديك إدخال في نظام أسماء النطاقات:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

ضبط مكوّنات Edge بعد التثبيت

لضبط Edge بعد التثبيت، يمكنك استخدام مجموعة من ملفات .properties وأدوات Edge المساعدة. على سبيل المثال، لضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) على واجهة مستخدم Edge، عليك تعديل ملفات ‎.properties لضبط السمات اللازمة. تتطلّب التغييرات على ملفات .properties إعادة تشغيل مكوّن Edge المتأثر.

توجد ملفات .properties في الدليل /opt/apigee/customer/application. يحتوي كل مكوّن على ملف .properties الخاص به في هذا الدليل. على سبيل المثال، router.properties وmanagement-server.properties.

لضبط سمة لأحد المكوّنات، عدِّل ملف .properties المقابل، ثم أعِد تشغيل المكوّن:

> /opt/apigee/apigee-service/bin/apigee-service component restart

على سبيل المثال:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

عند تحديث Edge، تتم قراءة ملفات ‎.properties في الدليل /opt/apigee/customer/application. وهذا يعني أنّ التحديث يحتفظ بأي سمات تضبطها على المكوّن.

يُرجى الاطّلاع على كيفية ضبط Edge لمزيد من المعلومات حول ضبط Edge.

التأكّد من أنّ Edge Router يمكنه الوصول إلى ‎ /etc/rc.d/init.d/functions

يستخدم كل من Edge Router وBaaS Portal جهاز توجيه Nginx ويتطلبان إذن الوصول للقراءة إلى /etc/rc.d/init.d/functions.

إذا كانت عملية الأمان تتطلّب منك ضبط الأذونات على /etc/rc.d/init.d/functions، لا تضبطها على 700 وإلا سيتعذّر بدء تشغيل جهاز التوجيه. يمكن ضبط الأذونات على 744 للسماح بالوصول للقراءة إلى /etc/rc.d/init.d/functions.

استدعاء الأوامر على مكوّنات Edge

يثبّت Edge أدوات الإدارة ضمن /opt/apigee/apigee-service/bin التي يمكنك استخدامها لإدارة عملية تثبيت Edge. على سبيل المثال، يمكنك استخدام الأداة المساعدة apigee-all لبدء جميع مكوّنات Edge على العقدة أو إيقافها أو إعادة تشغيلها أو تحديد حالتها:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

استخدِم الأداة المساعدة apigee-service للتحكّم في المكوّنات الفردية وضبطها. تتّخذ الأداة المساعدة apigee-service الشكل التالي:

/opt/apigee/apigee-service/bin/apigee-service component action

على سبيل المثال، لإعادة تشغيل جهاز توجيه Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

يمكنك تحديد قائمة المكوّنات المثبّتة على العقدة من خلال فحص الدليل /opt/apigee. يحتوي هذا الدليل على دليل فرعي لكل مكوّن Edge مثبّت على العقدة. ويكون كل دليل فرعي مسبوقًا بما يلي:

• apigee: مكوّن تابع لجهة خارجية يستخدمه Edge. على سبيل المثال، apigee-cassandra.
• ‫edge: مكوّن Edge من Apigee على سبيل المثال، edge-management-server.
• edge-mint: مكوّن لتحقيق الربح على سبيل المثال، edge-mint-management-server.
• baas: مكوّن واجهة برمجة تطبيقات BaaS على سبيل المثال، baas-usergrid.

تعتمد القائمة الكاملة للإجراءات الخاصة بمكوّن معيّن على المكوّن نفسه، ولكن جميع المكوّنات تتيح الإجراءات التالية:

• بدء وإيقاف وإعادة تشغيل
• status, version
• الاحتفاظ بنسخة احتياطية، استعادة
• تثبيت، إلغاء تثبيت

الوصول إلى ملفات السجلّ

تتم كتابة ملف السجلّ لـ apigee-setup والنص البرمجي setup.sh في /tmp/setup-root.log.

تتوفّر ملفات السجلّ لكل مكوّن في الدليل /opt/apigee/var/log. لكل مكوّن دليل فرعي خاص به. على سبيل المثال، تتوفر سجلّات خادم الإدارة في الدليل:

/opt/apigee/var/log/edge-management-server

أوامر Yum الشائعة

تعتمد أدوات تثبيت Edge لنظام التشغيل Linux على Yum لتثبيت المكوّنات وتحديثها. قد تحتاج إلى استخدام عدة أوامر Yum لإدارة عملية تثبيت على عقدة.

• امسح جميع ذاكرات التخزين المؤقت في Yum:
  sudo yum clean all
• لتحديث أحد مكوّنات Edge:
  sudo yum update componentName
  على سبيل المثال:
  sudo yum update apigee-setup
  sudo yum update edge-management-server

بنية نظام الملفات

يثبِّت Edge جميع الملفات في الدليل /opt/apigee.

In this guide and in the Edge Operations Guide, the root installation directory is noted as:

<inst_root>/apigee

يستخدم التثبيت بنية نظام الملفات التالية لنشر Apigee Edge for Private Cloud.

ملفات السجلّ

البيانات