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:
- نزِّل ملف bootstrap_4.17.01.sh من Edge إلى /tmp/bootstrap_4.17.01.sh.
- ثبِّت أداة apigee-service على Edge. والتبعيات لديك.
- ثبِّت أداة apigee-setup وتبعيات Edge.
راجع تثبيت إعداد واجهة برمجة التطبيقات Edge متعددة للمزيد.
- استخدام 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 يمكن الوصول إليها:
- أنشئ الملف في أحد المحرّرين مثل أي مستخدم.
- قطعت مالك الملف إلى "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
توضح الجداول التالية موقع ملفات السجل:
|
المكوّنات |
الموقع الجغرافي |
|---|---|
|
خادم الإدارة |
<inst_root>/apigee/var/log/edge-management-server |
|
جهاز التوجيه |
<inst_root>/apigee/var/log/edge-router |
|
معالج الرسائل |
<inst_root>/apigee/var/log/edge-message-processor |
|
خادم Apigee Qpid |
<inst_root>/apigee/var/log/edge-qpid-server |
|
خادم Apigee Postgres |
<inst_root>/apigee/var/log/edge-postgres-server |
|
واجهة مستخدم Edge |
<inst_root>/apigee/var/log/edge-ui |
|
ZooKeeper |
<inst_root>/apigee/var/log/apigee-zookeeper |
|
OpenLDAP |
<inst_root>/apigee/var/log/apigee-openldap |
|
كاساندرا |
<inst_root>/apigee/var/log/apigee-cassandra |
|
لوحة مفاتيح Qpidd |
<inst_root>/apigee/var/log/apigee-qpidd |
|
قاعدة بيانات PostgreSQL |
<inst_root>/apigee/var/log/apigee-postgresql |
البيانات
|
المكوّنات |
الموقع الجغرافي |
|---|---|
|
خادم الإدارة |
<data_root>/apigee/data/edge-management-server |
|
جهاز التوجيه |
<data_root>/apigee/data/edge-router |
|
معالج الرسائل |
<data_root>/apigee/data/edge-message-processor |
|
وكيل Apigee Qpid |
<data_root>/apigee/data/edge-qpid-server |
|
وكيل Apigee Postgres |
<data_root>/apigee/data/edge-postgres-server |
|
ZooKeeper |
<data_root>/apigee/data/apigee-zookeeper |
|
OpenLDAP |
<data_root>/apigee/data/apigee-openldap |
|
كاساندرا |
<data_root>/apigee/data/apigee-cassandra/data |
|
لوحة مفاتيح Qpidd |
<data_root>/apigee/data/apigee-qpid/data |
|
قاعدة بيانات PostgreSQL |
<data_root>/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.
تعتمد القائمة الكاملة بالإجراءات للمكون على المكون نفسه، ولكن كل والمكونات على الإجراءات التالية:
- بدء، إيقاف، إعادة تشغيل
- الحالة، الإصدار
- الاحتفاظ بنسخة احتياطية والاستعادة
- تثبيت، إلغاء التثبيت