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

Edge for Private Cloud - الإصدار 4.17.01

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

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

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

  • يمكنك إيقاف SELinux على العقدة أو ضبطه على الوضع المتساهِل. راجِع تثبيت أداة إعداد واجهة برمجة التطبيقات Edge لمعرفة المزيد.
  • حدد ما إذا كنت تريد تفعيل مصادقة Cassandra.
  • حدد ما إذا كنت تريد إعداد النسخ المماثل في وضع الاستعداد الرئيسي لتطبيق Postgres.
  • حدد إعدادات Edge من قائمة الطبولوجيات الموصى بها. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. لمزيد من المعلومات، يمكنك الاطّلاع على إعداد النسخ المماثل لوضع الاستعداد لـ Postgres.
  • على كل عقدة في المخطط المحدد، ثبِّت الأداة المساعدة apigee-setup في Edge:
    • نزِّل ملف Edge bootstrap_4.17.01.sh من أجل /tmp/bootstrap_4.17.01.sh.
    • ثبِّت الأداة المساعدة apigee-service التابعة لـ Edge والتبعيات.
    • ثبِّت الأداة المساعدة apigee-setup والتبعيات في Edge.

      راجِع تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge لمزيد من المعلومات.
  • استخدِم الأداة المساعدة apigee-setup لتثبيت مكوّن واحد أو أكثر من مكوّنات Edge في كل عقدة استنادًا إلى المخطط الذي اخترته.
    يُرجى الاطّلاع على تثبيت مكونات Edge على عقدة.
  • في عقدة خادم الإدارة، استخدم الأداة المساعدة apigee-setup لتثبيت apigee-provision، وهي الأدوات المساعدة التي تستخدمها لإنشاء مؤسسات Edge وإدارتها.
    يُرجى الاطّلاع على إعداد المؤسسة لمزيد من المعلومات.

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

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

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

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

بالإضافة إلى ذلك، تنشئ أداة تثبيت Edge مستخدمًا جديدًا على نظامك، باسم "apigee". يستدعي العديد من أوامر Edge برنامج sudo لتشغيله كمستخدم "apigee".

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

  • أوامر أداة apigee-service، بما في ذلك:
    • apigee-service، مثل البدء والإيقاف وإعادة التشغيل والضبط.
    • apigee-all مثل start ووقف وإعادة تشغيل و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، يمكنك محاولة تصحيح المشكلة، ثم تشغيل أداة التثبيت مرة أخرى. تم تصميم أداة التثبيت ليتم تشغيلها بشكل متكرر في الحالات التي يتم فيها رصد حدوث عطل، أو إذا أردت لاحقًا تغيير مكوّن أو تحديثه بعد التثبيت.

تثبيت على الإنترنت أو بدون اتصال بالإنترنت

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

  • العُقد التي لها اتصال خارجي بالإنترنت

    يمكن للعُقد التي تتضمّن اتصال إنترنت خارجي الوصول إلى مستودع Apigee لتثبيت Edge RPM والتبعيات.
  • العُقد التي لا تحتوي على اتصال إنترنت خارجي

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

    ملاحظة: لا تستضيف Apigee جميع العناصر الاعتمادية التابعة لجهات خارجية في مستودعاتنا العامة. ويجب تنزيل هذه التبعيات وتثبيتها من مستودعات متاحة للجميع.

    لإنشاء مستودع Apigee داخلي، يجب أن يتوفر لديك عقدة تتضمن اتصالاً خارجيًا بالإنترنت لتتمكن من تنزيل Edge RPMs والتبعيات. بعد إنشاء المخزن الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة الوصول إلى تلك العقدة من عُقد Edge لتثبيتها.

استخدام مستودع Edge المحلي للحفاظ على إصدار Edge

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

مع ذلك، هناك ميزة أخرى لاستخدام مستودع محلي، حتى بالنسبة إلى العُقد التي تحتوي على اتصال خارجي بالإنترنت. عند تثبيت Edge من مستودع Apigee العام، يتم دائمًا تثبيت أحدث إصدارات Edge RPM. لذلك، إذا أردت تنزيل وتخزين Edge RPMs لإصدار معيّن من Edge، عليك إنشاء مستودع محلي لهذا الإصدار من Edge. يمكنك بعد ذلك استخدام هذا المخزن المحلي لإجراء عمليات التثبيت لأي إصدار من إصدارات Edge.

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

يتميز المستودع المعكوس بالمرونة للغاية. على سبيل المثال، يمكنك إنشاء مخزن مطابق من أحدث إصدارات Edge RPM أو من إصدار معيّن من Edge. بعد إنشاء الريبو، يمكنك أيضًا تعديله لإضافة الأرباح لكل ألف مشاهدة (RPM) من إصدارات Edge المختلفة. راجِع تثبيت أداة إعداد واجهة برمجة التطبيقات Edge لمعرفة المزيد.

حل تبعيات تثبيت RPM

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

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

أوامر 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.

في هذا الدليل وفي دليل عمليات Edge، يتم ذكر دليل تثبيت الجذر على النحو التالي:

<inst_root>/apigee

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

ملفات السجل

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

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

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

تسرد الجداول التالية موقع ملفات السجلّ:

المكوّنات

الموقع الجغرافي

خادم الإدارة

<inst_root>/apigee/var/log/edge-management-server

جهاز التوجيه

<inst_root>/apigee/var/log/edge-router

معالج الرسائل

<inst_root>/apigee/var/log/edge-message-processor

خادم Apigee Qpid

<inst_root>/apigee/var/log/edge-qpid-server

خادم Apigee Postgres

<inst_root>/apigee/var/log/edge-postgres-server

واجهة مستخدم Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

من الفئة العمرية 31-45

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

قاعدة بيانات PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

البيانات

المكوّنات

الموقع الجغرافي

خادم الإدارة

<data_root>/apigee/data/edge-management-server

جهاز التوجيه

<data_root>/apigee/data/edge-router

معالج الرسائل

<data_root>/apigee/data/edge-message-processor

وكيل Apigee Qpid

<data_root>/apigee/data/edge-qpid-server

وكيل Apigee Postgres

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

من الفئة العمرية 31-45

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

قاعدة بيانات PostgreSQL

<data_root>/apigee/data/apigee-postgres/pgdata

مهام ما بعد التثبيت

بعد اكتمال التثبيت، يمكنك تنفيذ إجراءات إضافية على مكونات Edge.

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

لإعداد Edge بعد التثبيت، يمكنك استخدام مجموعة من ملفات .properties والأدوات المساعدة في Edge. على سبيل المثال، لضبط بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة على واجهة مستخدم 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

أدوات إدارة تثبيت 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.

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

  • بدء، إيقاف، إعادة تشغيل
  • الحالة، الإصدار
  • الاحتفاظ بنسخة احتياطية، استعادة
  • تثبيت، إلغاء تثبيت