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

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

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

يُرجى العِلم أنّ تثبيت Edge على عقدة هو عملية متعددة الخطوات:

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

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

• أوامر أداة 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.53.00.sh وشغِّله:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.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. بعد أن يُثبِّت المستخدم الجذر حِزم 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 والتبعيات.

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

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

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

ملفات السجلّ

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