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

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

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

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

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

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

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

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

موقع إعدادات التثبيت الملفات

يجب عليك تمرير ملف تهيئة إلى الأداة 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 على العُقد بدون اتصال خارجي بالإنترنت، كما هو موضح في القسم السابق.

ومع ذلك، هناك ميزة أخرى لاستخدام مستودع محلي، حتى بالنسبة للعقد ذات المستودع الخارجي الاتصال بالإنترنت. عند تثبيت 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، تتم الإشارة إلى دليل التثبيت الجذري كـ:

<inst_root>/apigee

تستخدم عملية التثبيت بنية نظام الملفات التالية لنشر Apigee Edge for Private السحابة الإلكترونية

ملفات السجلّ

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

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

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

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

المكوّنات

الموقع الجغرافي

خادم الإدارة

&lt;inst_root&gt;/apigee/var/log/edge-management-server

جهاز التوجيه

&lt;inst_root&gt;/apigee/var/log/edge-router

معالج الرسائل

&lt;inst_root&gt;/apigee/var/log/edge-message-processor

خادم Apigee Qpid

&lt;inst_root&gt;/apigee/var/log/edge-qpid-server

خادم Apigee Postgres

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

واجهة مستخدم Edge

&lt;inst_root&gt;/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

&lt;inst_root&gt;/apigee/var/log/apigee-openldap

كاساندرا

&lt;inst_root&gt;/apigee/var/log/apigee-cassandra

لوحة مفاتيح Qpidd

&lt;inst_root&gt;/apigee/var/log/apigee-qpidd

قاعدة بيانات PostgreSQL

&lt;inst_root&gt;/apigee/var/log/apigee-postgresql

البيانات

المكوّنات

الموقع الجغرافي

خادم الإدارة

&lt;data_root&gt;/apigee/data/edge-management-server

جهاز التوجيه

&lt;data_root&gt;/apigee/data/edge-router

معالج الرسائل

&lt;data_root&gt;/apigee/data/edge-message-processor

وكيل Apigee Qpid

&lt;data_root&gt;/apigee/data/edge-qpid-server

وكيل Apigee Postgres

&lt;data_root&gt;/apigee/data/edge-postgres-server

ZooKeeper

&lt;data_root&gt;/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

كاساندرا

&lt;data_root&gt;/apigee/data/apigee-cassandra/data

لوحة مفاتيح Qpidd

&lt;data_root&gt;/apigee/data/apigee-qpid/data

قاعدة بيانات PostgreSQL

&lt;data_root&gt;/apigee/data/apigee-postgres/pgdata

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

بعد اكتمال التثبيت، يمكنك تنفيذ إجراءات إضافية على مكونات 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.

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

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