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

الإصدار 4.18.01 من Edge الخاص بخدمة Private Cloud

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

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

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

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

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

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

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

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

لإعداد مستخدم يمتلك إذن وصول sudo الكامل إلى مستخدم "apigee"، استخدِم الأمر "visudo" لتعديل ملف sudoers لإضافة:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

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

  1. المهام التي يتم تنفيذها من خلال الجذر:
    1. قم بتنزيل ملف bootstrap_4.18.01.sh وتشغيله:??
      > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=apigeeuser التعرّف على الخطوة "
      apigeeuser=uName
    2. اضبط المستخدم للحصول على إذن وصول كامل إلى برنامج "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 تثبيت

      تعتمد قيم Edge RPM التي تثبّتها على العقدة على المخطط الهيكلي الخاص بك. وتتضمّن قائمة المكوّنات المتاحة ما يلي: apigee-provision, apigee-التحقّق, apigee-zookeeper, apigee-cassandra, apigee-openldap, Edge-ui, Edge-management-server، Edge-ui، Edge-router، Edge-message-processor، apigee-postgresql، apigee-postgresql, apigee-postgridid-server-Edge.
  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 على العقدة وإضافة الملف إلى "apigee:apigee".

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

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

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

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

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

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

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

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

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

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

    لإنشاء مستودع 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

/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

Qpidd

/opt/apigee/var/log/apigee-qpidd

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

/opt/apigee/var/log/apigee-postgresql

البيانات

المكوّنات

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

خادم الإدارة

/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

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

بعد اكتمال التثبيت، يمكنك تنفيذ إجراءات إضافية على مكونات 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.

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

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