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

الإصدار 4.18.05 من Edge for Private Cloud

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

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

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

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

      لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.

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

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

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

    لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مؤسسة.

  8. أعِد تشغيل مكوّن واجهة مستخدم Edge بعد اكتمال عملية التثبيت.

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

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من حِزم RPM والتبعيات. لتثبيت حزم 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". Many Edge commands invoke sudo to run as the "apigee" user.

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

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

إنشاء مستخدم لديه إذن وصول كامل إلى sudo لمستخدم "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 لمستخدم "apigee".

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

      تؤدي هذه الخطوة إلى تثبيت الأداة المساعدة apigee-service وإنشاء المستخدم "apigee".

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

      تعتمد حِزم RPM في Edge التي تثبّتها على العقدة على المخطط. وتتضمّن قائمة المكوّنات المتاحة ما يلي: 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 على العقدة وغيِّر ملكيته إلى "apigee:apigee" باستخدام الأمر chown.

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

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

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

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

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

التثبيت باستخدام الإنترنت أو بدونه

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

  • العُقد التي تتضمّن اتصالاً خارجيًا بالإنترنت

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

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

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

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

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

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

حلّ مشاكل التبعيات في تثبيت 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، يُشار إلى دليل التثبيت الجذر على النحو التالي:

/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 Router باستخدام 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 UI /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /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
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
قاعدة بيانات PostgreSQL /opt/apigee/data/apigee-postgres/pgdata

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

بعد اكتمال التثبيت، يمكنك تنفيذ إجراءات إضافية على مكوّنات Edge.

إعادة تشغيل مكوّن واجهة مستخدم Edge

بعد اكتمال التثبيت، يجب إعادة تشغيل مكوّن واجهة مستخدم Edge على كل عقدة:

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

ضبط مكوّنات 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_name action

حيث يحدّد component_name المكوّن. يجب أن يكون المكوّن على العقدة التي يتم تنفيذ apigee-service عليها. استنادًا إلى الإعدادات، يمكن أن تتضمّن قيم component_name ما يلي:

  • apigee-cassandra (كاساندرا)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qbidd)
  • apigee-sso (الدخول الموحّد في Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (خادم الإدارة)
  • edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • edge-qpid-server (خادم Qbid)
  • edge-router (جهاز توجيه الحواف)
  • edge-ui (واجهة المستخدم الكلاسيكية)

بالإضافة إلى هذه المكوّنات، يمكنك أيضًا استدعاء apigee-service على المكوّنَين apigee-provision وapigee-validate حسب الإعدادات التي تضبطها.

على سبيل المثال، لإعادة تشغيل Edge Router، نفِّذ الأمر التالي:

/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.

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

  • start, stop, restart
  • status, version
  • backup, restore
  • install, uninstall

تفعيل ميزة "التحقّق من النظام عند التثبيت"

يتيح ملف إعدادات تثبيت Edge استخدام السمة التالية:

ENABLE_SYSTEM_CHECK=y

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