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

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

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

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

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

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

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

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

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

• apigee-service:
  • apigee-service: تثبيت، إلغاء تثبيت، تحديث.
  • apigee-all: install, install, update.
• setup.sh النصي لتثبيت مكونات Edge (ما لم تكن قد استخدمت "تثبيت خدمة apigee" إلى تثبيت العائد المطلوب لكل ألف ظهور. ثم الوصول إلى الجذر أو برنامج sudo الكامل إذا لم يكن ذلك مطلوبًا).
• النص البرمجي update.sh لتحديث مكونات Edge

بالإضافة إلى ذلك، تنشئ أداة تثبيت Edge مستخدمًا جديدًا على نظامك، باسم "apigee". العديد من أوامر Edge استدعاء sudo لتشغيله على أنه "apigee" المستخدم.

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

• أوامر apigee-service، بما في ذلك:
  • أوامر apigee-service مثل start، وstop، و العائد، وconfig.
  • أوامر apigee-all مثل start،stop، إعادة تشغيل، ضبط.

قد يؤدي إنشاء مستخدم باستخدام وصول كامل لـ sudo إلى "apigee" مستخدم

لتكوين مستخدم لديه إمكانية الدخول الكامل إلى sudo إلى "apigee". استخدم "visudo" أمر موجَّه إلى تعديل ملف sudoers لإضافة ما يلي:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

في حين أن تنفيذ عملية تثبيت Edge بالكامل كجذر أو من خلال مستخدم لديه إمكانية وصول كاملة إلى برنامج sudo، وهذا ليس ممكنًا دائمًا. بدلاً من ذلك، يمكنك فصل عملية إلى مهام ينفذها الجذر والمهام التي يجريها المستخدم وصول كامل لـ sudo إلى "apigee" المستخدم.

1. المهام التي يتم تنفيذها بواسطة الجذر:
   1. عليك تنزيل ملف bootstrap_4.18.01.sh وتشغيله:
      > ضفيرة 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=uName apigeepassword=pWord
      
      تثبّت هذه الخطوة أداة apigee-service وتنشئ "apigee" المستخدم.
   2. إعداد مستخدم لمنحه إذن الوصول الكامل إلى واجهة برمجة التطبيقات "apigee" للمستخدم كما هو موضح أعلاه.
   3. ثبِّت الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. استخدام الأداة apigee-setup للتثبيت الحدّ الأقصى للعائدات لكل ألف مشاهدة (RPM) على العقدة:
      > /opt/apigee/apigee-service/bin/apigee-service compName تثبيت
      
      تعتمد قيمة Edge RPM التي تقوم بتثبيتها على العقدة على المخطط لديك. قائمة الخدمات المتوفرة ما يلي: apigee-provision، apigee-verifyate، apigee-zookeeper، apigee-cassandra، apigee-openldap، Edge-ui Edge-management-server وEdge-ui وEd-router Edge-message-processor ، apigee-postgresql، apigee-qpidd، Edge-postgres-server، Edge-qpid-server.
2. بعد تثبيت المستخدم الجذر للعائدات لكل ألف ظهور على 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 في العقدة وغيِّرها إلى "apigee:apigee".

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

راجع تثبيت مكونات Edge على عقدة للحصول على أخرى.

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

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

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

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

• العُقد المزوّدة باتصال إنترنت خارجي
  
  تصل العُقد ذات اتصال الإنترنت الخارجي إلى مستودع Apigee لتثبيت Edge. الأرباح لكل ألف مشاهدة (RPM) والتبعيات.
• العُقد بدون اتصال خارجي بالإنترنت
  
  يمكن للعُقد التي لا يتوفّر لها اتصال إنترنت خارجي الوصول إلى إصدار مطابق من Apigee تقوم بإعداده داخليًا. يحتوي هذا المستودع على جميع العائدات لكل ألف مشاهدة (RPM) في شبكة Edge، ولكن يجب والتأكد من أن لديك جميع التبعيات الأخرى المتاحة من المستودعات على الشبكة.
  
  ملاحظة: لا تستضيف Apigee جميع الموارد التابعة لجهات خارجية في المتاحة للجميع المستودعات. يجب تنزيل هذه التبعيات وتثبيتها من قائمة يمكن للجميع الوصول إليها المستودعات.
  
  لإنشاء مستودع 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 componentName
  مثال:
  تحديث sudo yum apigee-setup
  sudo yum update-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.

جارٍ إعداد شبكة 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 action

على سبيل المثال، لإعادة تشغيل جهاز توجيه Edge:

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

يمكنك تحديد قائمة المكوّنات المثبّتة على العقدة عن طريق فحص دليل /opt/apigee. دَلِيلْ دَهْ يحتوي على دليل فرعي لكل مكون من مكونات Edge المثبت على العقدة. يُعد كل دليل فرعي مسبوقة بـ:

• apigee - جهة خارجية المكون الذي تستخدمه Edge. على سبيل المثال، apigee-cassandra.
• edge - مكوّن Edge من Apigee. على سبيل المثال، Eedge-management-server.
• edge-mint - تحقيق الربح المكون. على سبيل المثال، edge-mint-management-server.
• baas - واجهة برمجة التطبيقات BaaS المكون. على سبيل المثال baas-usergrid.

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

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