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

Edge for Private Cloud، الإصدار 4.17.09

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

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

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

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

1. المهام التي يتم تنفيذها بواسطة الجذر:
   1. نزِّل ملف bootstrap_4.17.09.sh وشغِّله:
      . > ضفيرة https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.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 أداة لتثبيت Edge 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، أو 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 على وحوله إلى "apigee:apigee".

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

الاطّلاع على تثبيت Edge على أي عقدة لمعرفة المزيد.

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

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

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

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

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

يمكن أن يؤدي استخدام مستودع Edge المحلي إبقاء إصدار Edge

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

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

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

المستودع المعكوس مرن للغاية. على سبيل المثال، يمكنك إنشاء مستودع على الجهاز وفي السحابة الإلكترونية من أحدث قائمة. عدد الأرباح لكل ألف مشاهدة (RPM) في Edge أو من إصدار معيّن من Edge. بعد إنشاء المستودع، يمكنك أيضًا تعديله. لإضافة العائدات لكل ألف ظهور من إصدارات Edge المختلفة. اطلِع على تثبيت Edge apigee-setup للمزيد.

حل مشكلة اعتماديات تثبيت 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.

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

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