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

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

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

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

يُرجى العِلم أنّ تثبيت Edge على عقدة هو عملية متعددة الخطوات:

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

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

مَن يمكنه إجراء عملية التثبيت

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

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

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

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

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

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

لمنح مستخدم إذن وصول sudo كاملاً إلى مستخدم apigee، عدِّل ملف sudoers لإضافة:

installUser        ALL=(apigee)      NOPASSWD: ALL

حيث يكون installUser هو اسم المستخدم الذي يعمل مع Edge.

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

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

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

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

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

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

اطّلِع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.

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

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

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

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

  • العقد التي تتوفّر فيها إمكانية الاتصال بالإنترنت الخارجي

    يمكن للعقد التي تتوفّر فيها إمكانية الاتصال بالإنترنت الخارجي الوصول إلى مستودع Apigee لتثبيت حِزم RPM الخاصة بـ Edge والملفات الملحقة.
  • العقد التي لا تتوفّر فيها إمكانية الاتصال بالإنترنت الخارجي

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

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

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

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

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

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

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

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

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

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

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

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

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

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

كاساندرا

&lt;inst_root&gt;/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

جهاز التوجيه

&lt;data_root&gt;/apigee/data/edge-router

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

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

وكيل Qpid في Apigee

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

وكيل Apigee Postgres

&lt;data_root&gt;/apigee/data/edge-postgres-server

ZooKeeper

&lt;data_root&gt;/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

كاساندرا

<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. على سبيل المثال، لضبط بروتوكول 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

تثبّت 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 Router:

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

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

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

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

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