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

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

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

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

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

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

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

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

  7. في عقدة Management Server، استخدِم الأداة 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 كمجموعة من RPM والتبعيات. لتثبيت Edge RPMs وإلغاء تثبيته وتحديثه، يجب تشغيل الأوامر من قِبل المستخدم الجذر أو مستخدم لديه إذن وصول كامل إلى برنامج 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-service، بما في ذلك:
    • apigee-service، مثل start, stop, restart, configure.
    • apigee-all، مثل start, stop, restart, configure.

إنشاء مستخدم لديه حق الوصول الكامل إلى مستخدم "apigee"

لإعداد مستخدم لديه إذن الوصول الكامل إلى مستخدم "apigee"، استخدِم الأمر "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، إلا أنّ ذلك ليس ممكنًا في بعض الأحيان. بدلاً من ذلك، يمكنك تقسيم العملية إلى مهام تؤديها حسب الجذر والمهام التي ينفّذها مستخدم لديه إذن وصول كامل إلى المستخدم "apigee".

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

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

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

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

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

    لإنشاء مستودع Apigee الداخلي، يجب أن تحتاج إلى عقدة لديها اتصال خارجي بالإنترنت لتتمكن من تنزيل Edge RPMs والتبعيات. بعد إنشاء repo الداخلي، يمكنك نقلها إلى عقدة أخرى أو إتاحة الوصول إلى تلك العقدة من عُقد 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 على السحابة الإلكترونية الخاصة.

ملفات السجلّ

تتم كتابة ملف السجلّ 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".