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

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

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

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

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

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

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

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

  7. في عقدة "خادم الإدارة"، استخدِم الأداة apigee-setup لتثبيت apigee-provision، وهي الأدوات المساعدة التي تستخدمها لإنشاء مؤسسات Edge وإدارتها.

    لمزيد من المعلومات، راجِع المقالة إعداد مؤسسة.

  8. أعِد تشغيل مكوِّن واجهة المستخدم الكلاسيكية على كل عقدة بعد اكتمال التثبيت، كما يبيِّن المثال التالي: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (موصى به) بعد إكمال عملية التثبيت الأولية، تقترح Apigee تثبيت واجهة مستخدم Edge الجديدة (التي يكون اسم مكوِّنها edge-management-ui)، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

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

بعد اكتمال التثبيت، راجع قائمة الإجراءات الشائعة التالية للتثبيت.

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

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من العائدات لكل ألف ظهور والتبعيات. لتثبيت مقياس Edge RPM وإلغاء تثبيته وتحديثه، يجب تشغيل الأوامر من قِبل المستخدم الجذر أو مستخدم لديه إذن الوصول الكامل إلى برنامج 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". تستدعي العديد من أوامر Edge sudo لتشغيلها كمستخدم "apigee".

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

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

إنشاء مستخدم يمتلك إمكانية الوصول الكامل إلى برنامج sudo للمستخدم "apigee"

لإعداد مستخدم لمنحه إذن الوصول الكامل إلى برنامج sudoers، استخدِم الأمر "visudo" لتعديل ملف sudoers لإضافته إلى ما يلي:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

إعداد الأذونات على ملفات الإعداد

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

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

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

فصل مهام تثبيت Edge بين المستخدم الجذر والمستخدم غير الجذر

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

  1. المهام التي يتم تنفيذها باستخدام الجذر:
    1. نزِّل ملف bootstrap_4.52.02.sh وشغِّله: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      تُثبّت هذه الخطوة الأداة apigee-service وتُنشئ المستخدِم "apigee".

    2. اضبط المستخدم لمنحه إذن الوصول الكامل إلى نظام sudo للمستخدم "apigee"، كما هو موضّح في إنشاء مستخدم لديه إذن وصول كامل إلى مستخدم "apigee".
    3. ثبِّت أداة apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. استخدِم الأداة apigee-setup لتثبيت Edge RPM على العقدة: 
      /opt/apigee/apigee-service/bin/apigee-service compName install

      تعتمد قيمة Edge RPM التي تقوم بتثبيتها على العقدة على المخطط لديك. وتشمل قائمة المكونات المتاحة ما يلي: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

  2. بعد أن يثبّت مستخدم الجذر العائد لكل ألف ظهور من Edge على العقدة، يكمل المستخدم الذي لديه إذن وصول كامل إلى مستخدم "apigee" عملية الإعداد:
    1. استخدِم الأداة المساعدة setup.sh لإكمال ضبط مكونات Edge على العقدة. ويعتمد شكل الأمر على المكوّنات التي تم تثبيتها على العقدة. للحصول على القائمة الكاملة، راجِع تثبيت مكونات Edge على عقدة.

      على سبيل المثال، لإكمال تثبيت ZooKeeper وCassandra، استخدم الأمر التالي:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      حيث configFile هو ملف إعداد Edge.

      أو لإجراء تثبيت شامل، استخدِم الأمر التالي:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

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

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

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

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

التعامل مع إخفاق عملية التثبيت

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

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

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

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

  • العُقد المزوّدة باتصال إنترنت خارجي

    تصل العُقد ذات الاتصال الخارجي بالإنترنت إلى مستودع Apigee لتثبيت الإطارات لكل ألف ظهور في Edge والتبعيات.

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

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

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

استخدام مستودع Edge المحلي للحفاظ على إصدار 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، تتم الإشارة إلى دليل التثبيت الجذري على النحو التالي:

/opt/apigee

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

ملفات السجلّ

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

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

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

توضح الجداول التالية موقع ملفات السجل:

المكوِّن الموقع الجغرافي

خادم الإدارة

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

جهاز التوجيه

 /opt/apigee/var/log/edge-router

يتم تنفيذ جهاز توجيه Edge باستخدام Nginx. للحصول على سجلّات إضافية، يُرجى الاطّلاع على:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

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

 /opt/apigee/var/log/edge-message-processor

خادم Apigee Qpid

 /opt/apigee/var/log/edge-qpid-server
خادم Apigee Postgres /opt/apigee/var/log/edge-postgres-server
واجهة المستخدم الكلاسيكية (وليست واجهة مستخدم Edge الجديدة التي يكون اسم مكوّنها هو edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
كاساندرا /opt/apigee/var/log/apigee-cassandra/system.log
لوحة مفاتيح Qpidd /opt/apigee/var/log/apigee-qpidd
قاعدة بيانات PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

البيانات

المكوِّن الموقع الجغرافي
خادم الإدارة /opt/apigee/data/edge-management-server
جهاز التوجيه /opt/apigee/data/edge-router
معالج الرسائل /opt/apigee/data/edge-message-processor
وكيل Apigee Qpid /opt/apigee/data/edge-qpid-server
وكيل Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
كاساندرا /opt/apigee/data/apigee-cassandra/data
لوحة مفاتيح Qpidd /opt/apigee/data/apigee-qpid/data
قاعدة بيانات PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

تفعيل فحص النظام عند التثبيت

يتوافق ملف إعداد تثبيت Edge مع الخاصية التالية:

ENABLE_SYSTEM_CHECK=y

في حال ضبط هذه السمة على "y"، تتحقق أداة التثبيت من استيفاء النظام لمتطلبات وحدة المعالجة المركزية (CPU) والذاكرة للمكوِّن الذي يتم تثبيته. وتكون القيمة التلقائية هي "n" لإيقاف عملية التحقّق.