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

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

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

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

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

أي مستخدم يريد تنفيذ جميع الأوامر الأخرى غير الأوامر الواردة أعلاه يجب أن يكون مستخدمًا لديه وصول كامل لـ 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.

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

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

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

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

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

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

   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. بعد أن يثبّت المستخدم الجذر عائدات الأرباح لكل ألف مشاهدة (RPM) في شبكة Edge على العقدة، يصبح المستخدم لديه إمكانية الوصول الكامل إلى برنامج 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 تقوم بإعداده داخليًا. يحتوي هذا المستودع على جميع العائدات لكل ألف مشاهدة (RPM) في شبكة 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 السحابة الإلكترونية

ملفات السجلّ

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

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

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

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

البيانات

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

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

ENABLE_SYSTEM_CHECK=y

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