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

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

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

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

  1. يمكنك إيقاف SELinux على العقدة أو ضبطه على الوضع المتساهِل. راجِع تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge لمزيد من المعلومات.
  2. حدد ما إذا كنت تريد تفعيل مصادقة Cassandra.
  3. حدد ما إذا كنت تريد إعداد النسخ المماثل في وضع الاستعداد الرئيسي لتطبيق Postgres.
  4. حدد إعدادات Edge من قائمة الطبولوجيات الموصى بها. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. راجِع طرق التثبيت لمزيد من المعلومات.
  5. في كل عقدة في المخطط المحدد، ثبِّت الأداة apigee-setup Edge:
  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 لخدمات Private Cloud الخاصة.

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

بعد اكتمال التثبيت، يمكنك الاطّلاع على قائمة الإجراءات الشائعة هذه بعد التثبيت.

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

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من العائدات لكل ألف ظهور والتبعيات. لتثبيت برنامج 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".

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

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

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

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

  1. المهام التي يتم تنفيذها من خلال الجذر:
    1. نزِّل ملف bootstrap_4.51.00.sh وتشغيله: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
sudo bash /tmp/bootstrap_4.51.00.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 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 RPM على العُقدة، يُكمل المستخدم الذي يملك إذن الوصول الكامل إلى مستخدم "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 والتبعيات. بعد إنشاء المخزن الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة الوصول إلى تلك العقدة من عُقد 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 لخدمة 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
من الفئة العمرية 31-45 /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
من الفئة العمرية 31-45 /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" لإيقاف عملية التحقّق.