تتكون عملية تثبيت Edge النموذجية من مكونات Edge موزعة على عدة عُقد. بعد تثبيت Edge على عقدة، يمكنك تثبيت وضبط مكوّن واحد أو أكثر من مكوّنات Edge على العقدة.
عملية التثبيت
تثبيت Edge على عقدة هو عملية متعددة الخطوات:
- قم بإيقاف SELinux على العقدة أو عيِّنها على الوضع المتساهِل. راجِع تثبيت أداة إعداد apigee في Edge للحصول على مزيد من المعلومات.
- حدد ما إذا كنت تريد تفعيل مصادقة Cassandra.
- حدد ما إذا كنت تريد إعداد النسخ المماثل في وضع الاستعداد الرئيسي لـ Postgres.
- اختر إعدادات Edge من قائمة المخططات المُقترحة. على سبيل المثال، يمكنك تثبيت Edge في عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. لمزيد من المعلومات، يمكنك الاطّلاع على مخططات التثبيت.
- في كل عقدة في المخطط الزمني المحدّد، ثبِّت أداة
apigee-setup
Edge:- نزِّل ملف
bootstrap_4.52.01.sh
من Edge إلى/tmp/bootstrap_4.52.01.sh
. - ثبِّت أداة
apigee-service
Edge والتبعيات. - ثبِّت أداة
apigee-setup
Edge والتبعيات.راجِع تثبيت أداة إعداد apigee من Edge للحصول على مزيد من المعلومات.
- نزِّل ملف
- استخدِم الأداة المساعدة
apigee-setup
لتثبيت مكوّن واحد أو أكثر من مكوّنات Edge على كل عقدة بناءً على المخطط البياني الذي اخترته.يُرجى الاطّلاع على تثبيت مكونات Edge على أي عقدة.
- في عقدة Management Server، استخدِم الأداة
apigee-setup
لتثبيتapigee-provision
، وهي الأدوات المساعدة التي تستخدمها لإنشاء مؤسسات Edge وإدارتها.لمزيد من المعلومات، يُرجى الاطّلاع على الانضمام إلى مؤسسة.
- أعِد تشغيل المكوِّن الكلاسيكي لواجهة المستخدم في كل عقدة بعد اكتمال التثبيت،
على النحو الموضّح في المثال التالي:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(إجراء يُنصح به) بعد إكمال عملية التثبيت الأولية، تنصحك Apigee بتثبيت واجهة مستخدم Edge الجديدة (التي اسم مكوَّنها
edge-management-ui
)، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.ولمعرفة مزيد من المعلومات، يمكنك الاطّلاع على مقالة تثبيت واجهة مستخدم Edge الجديدة.
بعد اكتمال التثبيت، يمكنك الاطّلاع على قائمة الإجراءات الشائعة لما بعد التثبيت.
المستخدمون الذين يمكنهم إجراء التثبيت
يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من RPM والتبعيات. لتثبيت Edge RPMs وإلغاء تثبيته وتحديثه، يجب تشغيل الأوامر من قِبل المستخدم الجذر أو مستخدم لديه إذن وصول كامل إلى برنامج sudo. للحصول على إذن بالوصول الكامل إلى برنامج sudo، يعني ذلك أنّ المستخدم لديه إذن الوصول إلى برنامج sudo لإجراء العمليات نفسها كالجذر.
أي مستخدم يريد تشغيل الأوامر أو النصوص البرمجية التالية يجب أن يكون جذرًا أو مستخدمًا لديه إذن وصول كامل إلى برنامج sudo:
- أداة apigee-service:
- apigee-service:
install, uninstall, update
. - apigee-all:
install, uninstall, update
.
- apigee-service:
- النص البرمجي setup.sh لتثبيت مكوّنات Edge (ما لم تكن قد سبق لك استخدام
"
apigee-service install
" لتثبيت قيم RPM المطلوبة. بعد ذلك، يمكن الوصول إلى الجذر أو برنامج sudo الكامل إذا لم يكن مطلوبًا). - النص البرمجي update.sh لتحديث مكوّنات Edge
بالإضافة إلى ذلك، تنشئ أداة تثبيت Edge مستخدمًا جديدًا على نظامك، باسم "apigee". ويستدعي العديد من أوامر Edge برنامج sudo لتشغيله كمستخدم "واجهة برمجة تطبيقات".
أي مستخدم يريد تشغيل جميع الأوامر الأخرى غير الأوامر أعلاه يجب أن يكون مستخدمًا لديه إذن الوصول الكامل إلى المستخدم "apigee". تشمل هذه الأوامر ما يلي:
-
أوامر الأداة المساعدة apigee-service، بما في ذلك:
- apigee-service، مثل
start, stop, restart, configure
. - apigee-all، مثل
start, stop, restart, configure
.
- apigee-service، مثل
إنشاء مستخدم لديه حق الوصول الكامل إلى مستخدم "apigee"
لإعداد مستخدم لديه إذن الوصول الكامل إلى مستخدم "apigee"، استخدِم الأمر "visudo" لتعديل ملفّ sudoers وإضافة ما يلي:
installUser ALL=(apigee) NOPASSWD: ALL
حيث يكون installUser هو اسم المستخدم للشخص الذي يعمل في Edge.
تعيين أذونات على ملفات التهيئة
يجب أن يتمكن مستخدم "apigee" من الوصول إلى أي ملفات أو موارد تستخدمها أوامر Edge. ويشمل ذلك ملف ترخيص Edge وأي ملفات إعداد.
عند إنشاء ملف إعداد، يمكنك تغيير مالكه إلى "apigee:apigee" لضمان إمكانية وصول أوامر Edge إليه:
- أنشئ الملف في أحد المحرِّرات، مثل أي مستخدم.
chown
مالك الملف إلى "apigee:apigee"، أو إذا غيّرت حساب المستخدم الذي يشغّل خدمة Edge من مستخدم "apigee"، قم بإعادة ترتيب الملف إلى المستخدم الذي يشغّل خدمة Edge.
فصل مهام تثبيت Edge بين المستخدم الجذر وغير الجذر
إنّ من الأبسط إجراء عملية تثبيت Edge بالكامل كجذر أو من قِبل مستخدم لديه إذن وصول كامل إلى برنامج sudo، إلا أنّ ذلك ليس ممكنًا في بعض الأحيان. بدلاً من ذلك، يمكنك تقسيم العملية إلى مهام تؤديها حسب الجذر والمهام التي ينفّذها مستخدم لديه إذن وصول كامل إلى المستخدم "apigee".
- المهام التي يتم تنفيذها حسب الجذر:
- تنزيل ملف
bootstrap_4.52.01.sh
وتشغيله:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
تثبّت هذه الخطوة الأداة
apigee-service
وتنشئ مستخدم "apigee". - اضبط المستخدم لمنحه إذن الوصول الكامل إلى مستخدم "apigee" كما هو موضّح في إنشاء مستخدم لديه إذن وصول كامل إلى مستخدم "apigee".
- تثبيت الأداة
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم الأداة
apigee-setup
لتثبيت Edge RPMs على العقدة:/opt/apigee/apigee-service/bin/apigee-service compName install
تعتمد دورات Edge RPM التي تثبِّتها على العقدة على المخطط البياني الخاص بك. وتشمل قائمة المكوّنات المتاحة ما يلي:
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
.
- تنزيل ملف
- بعد أن يثبّت المستخدم الجذر إصدارات Edge RPM على العقدة، يتم إكمال عملية الإعداد من قِبل المستخدم الذي لديه إذن وصول كامل إلى sudo
إلى مستخدم "apigee":
- استخدم الأداة المساعدة
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 RPM والتبعيات.
- العُقد بدون اتصال إنترنت خارجي
يمكن للعُقد التي لا يتوفّر لها اتصال خارجي بالإنترنت الوصول إلى نسخة متطابقة من مستودع Apigee الذي أعددته داخليًا. يحتوي هذا المستودع على جميع شبكات Edge RPM، ولكن عليك التأكد من أن لديك جميع التبعيات الأخرى متاحة من المستودعات على الشبكة الداخلية.
لإنشاء مستودع Apigee الداخلي، يجب أن تحتاج إلى عقدة لديها اتصال خارجي بالإنترنت لتتمكن من تنزيل Edge RPMs والتبعيات. بعد إنشاء repo الداخلي، يمكنك نقلها إلى عقدة أخرى أو إتاحة الوصول إلى تلك العقدة من عُقد Edge للتثبيت.
استخدام مستودع Edge المحلي للحفاظ على إصدار Edge
وأحد أسباب استخدام مستودع محلي أو نسخة مطابقة له هو تثبيت Edge على عُقد بدون اتصال خارجي بالإنترنت، كما هو موضّح في القسم السابق.
حل تبعيات تثبيت RPM
يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من ملفات RPM، ويمكن أن يكون لكل ملف منها سلسلة خاصة من التثبيت. وتمّ تعريف العديد من هذه التبعيات من خلال مكوّنات تابعة لجهات خارجية خارجة عن سيطرة Apigee ويمكن تغييرها في أي وقت. وبالتالي، لا تتضمّن المستندات رقم الإصدار الواضح لكل تبعية.
إذا كنت تجري عملية تثبيت على جهاز متصل بالإنترنت، يمكن للعقدة تنزيل العائدات لكل ألف ظهور والتبعيات اللازمة. ومع ذلك، إذا كنت تثبّت من عقدة غير متصلة بالإنترنت، يمكنك عادةً إعداد مستودع داخلي يحتوي على جميع التبعيات اللازمة. وتتمثل الطريقة الوحيدة لضمان تضمين جميع التبعيات في مستودعك المحلي في محاولة التثبيت وتحديد أي تبعيات مفقودة ونسخها إلى المستودع المحلي إلى أن تنجح عملية التثبيت.
أوامر 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 على السحابة الإلكترونية الخاصة.
ملفات السجلّ
تتم كتابة ملف السجلّ apigee-setup
والنص البرمجي setup.sh
إلى /tmp/setup-root.log
.
ويتم تضمين ملفات السجلّ لكل مكوِّن في الدليل /opt/apigee/var/log
. لكل مكون دليل فرعي خاص به. على سبيل المثال، تتوفّر سجلات خادم الإدارة في الدليل:
/opt/apigee/var/log/edge-management-server
تسرد الجداول التالية موقع ملفات السجلّ:
المكوِّن | الموقع الجغرافي |
---|---|
خادم الإدارة |
/opt/apigee/var/log/edge-management-server
|
جهاز التوجيه |
/opt/apigee/var/log/edge-router
يتم تنفيذ جهاز توجيه Edge باستخدام Nginx. للتعرُّف على السجلات الإضافية، يُرجى الاطِّلاع على:
|
معالج الرسائل |
/opt/apigee/var/log/edge-message-processor
|
خادم Apigee Qpid |
/opt/apigee/var/log/edge-qpid-server
|
خادم Apigee Postgres | /opt/apigee/var/log/edge-postgres-server |
واجهة المستخدم الكلاسيكية (ليست واجهة مستخدم Edge الجديدة، التي يكون اسم مكوّنها edge-management-ui ) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
كاساندرا | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
قاعدة بيانات PostgreSQL | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
البيانات
المكوِّن | الموقع الجغرافي |
---|---|
خادم الإدارة | /opt/apigee/data/edge-management-server |
جهاز التوجيه | /opt/apigee/data/edge-router |
معالج الرسائل | /opt/apigee/data/edge-message-processor |
وكيل Apigee Qpid | /opt/apigee/data/edge-qpid-server |
وكيل Apigee Postgres | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
كاساندرا | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
قاعدة بيانات PostgreSQL | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
تفعيل فحص النظام عند التثبيت
يتوافق ملف إعداد تثبيت Edge مع الخاصية التالية:
ENABLE_SYSTEM_CHECK=y
إذا ضبطت هذه السمة على "y"، ستتحقّق أداة التثبيت من استيفاء النظام لمتطلبات وحدة المعالجة المركزية (CPU) والذاكرة للمكوِّن الذي يتم تثبيته. لإيقاف علامة الاختيار، تكون القيمة التلقائية "n".