يتكون تثبيت Edge النموذجي من مكونات Edge موزَّعة على عُقد متعددة. بعد تثبيت Edge على عقدة، يمكنك بعد ذلك تثبيت وتهيئة مكوّن واحد أو أكثر من مكونات Edge على العقدة.
عملية التثبيت
تثبيت Edge على عقدة هو عملية متعددة الخطوات:
- يمكنك إيقاف SELinux في العقدة أو ضبطه على الوضع المتساهِل. راجِع تثبيت أداة Edge apigee-setup لمعرفة مزيد من المعلومات.
- حدِّد ما إذا كنت تريد تفعيل مصادقة Cassandra.
- حدِّد ما إذا كنت تريد إعداد النسخ المتماثل الرئيسي في وضع الاستعداد لـ Postgres.
- حدد تهيئة Edge من قائمة المخططات الموصى بها. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار أو على 13 عقدة للإنتاج. يمكنك الاطلاع على سياسات التثبيت للتعرّف على مزيد من المعلومات.
- على كل عقدة في الهيكل المحدد، ثبِّت أداة Edge
apigee-setup
:- نزِّل ملف Edge
bootstrap_4.52.02.sh
إلى/tmp/bootstrap_4.52.02.sh
. - ثبِّت أداة Edge
apigee-service
والتبعيات. - ثبِّت أداة Edge
apigee-setup
والتبعيات.راجِع تثبيت أداة Edge apigee-setup للحصول على مزيد من المعلومات.
- نزِّل ملف Edge
- استخدم أداة
apigee-setup
لتثبيت مكوّن Edge واحد أو أكثر على كل عقدة استنادًا إلى المخطط الذي اخترته.اطلِع على تثبيت مكونات Edge على عقدة.
- في عقدة "خادم الإدارة"، استخدِم الأداة
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 كمجموعة من العائدات لكل ألف ظهور والتبعيات. لتثبيت مقياس Edge RPM وإلغاء تثبيته وتحديثه، يجب تشغيل الأوامر من قِبل المستخدم الجذر أو مستخدم لديه إذن الوصول الكامل إلى برنامج 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". وتتضمّن هذه الأوامر ما يلي:
-
أوامر apigee-service، بما في ذلك:
- أوامر apigee-service مثل
start, stop, restart, configure
. - أوامر apigee-all مثل
start, stop, restart, configure
.
- أوامر apigee-service مثل
إنشاء مستخدم يمتلك إمكانية الوصول الكامل إلى برنامج sudo للمستخدم "apigee"
لإعداد مستخدم لمنحه إذن الوصول الكامل إلى برنامج sudoers، استخدِم الأمر "visudo" لتعديل ملف sudoers لإضافته إلى ما يلي:
installUser ALL=(apigee) NOPASSWD: ALL
حيث يكون installUser هو اسم المستخدم للشخص الذي يعمل مع Edge.
إعداد الأذونات على ملفات الإعداد
يجب أن يتمكن مستخدم "apigee" من الوصول إلى أي ملفات أو موارد تستخدمها أوامر Edge. ويشمل ذلك ملف ترخيص Edge وأي ملفات إعداد.
عند إنشاء ملف إعداد، يمكنك تغيير مالكه إلى "apigee:apigee" لضمان إمكانية الوصول إليه من خلال أوامر Edge:
- أنشئ الملف في أحد المحرّرين مثل أي مستخدم.
chown
مالك الملف إلى "apigee:apigee"، أو في حال تغيير المستخدم الذي يشغّل خدمة Edge من مستخدم "apigee"، يتم اختيار الملف للمستخدم الذي يشغّل خدمة Edge.
فصل مهام تثبيت Edge بين المستخدم الجذر والمستخدم غير الجذر
إنّ تنفيذ عملية تثبيت Edge بالكامل كجذر أو من خلال مستخدم لديه إذن الوصول الكامل إلى برنامج sudo، إلا أنّ ذلك ليس ممكنًا في بعض الأحيان. بدلاً من ذلك، يمكنك فصل العملية إلى مهام ينفّذها الجذر والمهام التي يجريها مستخدم لديه إذن وصول كامل إلى ملف sudo (واجهة برمجة التطبيقات).
- المهام التي يتم تنفيذها باستخدام الجذر:
- نزِّل ملف
bootstrap_4.52.02.sh
وشغِّله:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
تُثبّت هذه الخطوة الأداة
apigee-service
وتُنشئ المستخدِم "apigee". - اضبط المستخدم لمنحه إذن الوصول الكامل إلى نظام sudo للمستخدم "apigee"، كما هو موضّح في إنشاء مستخدم لديه إذن وصول كامل إلى مستخدم "apigee".
- ثبِّت أداة
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم الأداة
apigee-setup
لتثبيت Edge RPM على العقدة:/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 على العقدة، يكمل المستخدم الذي لديه إذن وصول كامل إلى مستخدم "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 والتبعيات.
- العُقد بدون اتصال خارجي بالإنترنت
يمكن للعُقد التي لا تتضمّن اتصال إنترنت خارجي الوصول إلى إصدار مطابق لمستودع Apigee الذي أعددته داخليًا. يحتوي هذا المستودع على جميع العائدات لكل ألف مشاهدة في Edge، ولكن عليك التأكد من أنّ لديك جميع الاعتماديات الأخرى المتاحة من المستودعات على الشبكة الداخلية.
لإنشاء مستودع 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 update componentName
مثلاً:
sudo yum update apigee-setup
sudo yum update edge-management-server
هيكل نظام الملفات
تثبّت Edge جميع الملفات في دليل /opt/apigee
.
في هذا الدليل وفي دليل عمليات Edge، تتم الإشارة إلى دليل التثبيت الجذري على النحو التالي:
/opt/apigee
تستخدم عملية التثبيت بنية نظام الملفات التالية لنشر Apigee Edge for Private Cloud.
ملفات السجلّ
تمت كتابة ملف سجلّ 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" لإيقاف عملية التحقّق.