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

الإصدار 4.17.01 من Edge for Private Cloud

يتألف تثبيت Edge العادي من مكوّنات Edge موزّعة على عُقد متعددة. بعد تثبيت Edge على عقدة، يمكنك تثبيت مكوّن واحد أو أكثر من مكوّنات Edge وضبطه على العقدة.

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

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

  • أوقِف SELinux على العقدة أو اضبطه على وضع السماح. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
  • حدِّد ما إذا كنت تريد تفعيل مصادقة Cassandra.
  • حدِّد ما إذا كنت تريد إعداد النسخ المتماثل الرئيسي الاحتياطي لـ Postgres.
  • اختَر إعدادات Edge من قائمة المخططات المقترَحة. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد النسخ المتماثل الرئيسي/الاحتياطي لـ Postgres.
  • على كل عقدة في المخطط الذي اخترته، ثبِّت الأداة المساعدة apigee-setup في Edge:
    • نزِّل ملف Edge bootstrap_4.17.01.sh إلى ‎/tmp/bootstrap_4.17.01.sh.
    • ثبِّت أداة Edge apigee-service والتبعيات.
    • ثبِّت أداة Edge apigee-setup والتبعيات.

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

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

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

يجب أن يكون أي مستخدم يريد تشغيل الأوامر أو النصوص البرمجية التالية إما مستخدمًا جذرًا أو مستخدمًا لديه إذن وصول كامل إلى sudo:

  • apigee-service:
    • أوامر apigee-service: install, uninstall, update.
    • أوامر apigee-all: install, uninstall, update.
  • النص البرمجي setup.sh لتثبيت مكوّنات Edge (ما لم تكن قد استخدمت "apigee-service install" لتثبيت حِزم RPM المطلوبة. ثم إذن وصول من النوع الجذري أو النوع sudo الكامل إذا لم يكن مطلوبًا.)
  • النص البرمجي update.sh لتحديث مكوّنات Edge

بالإضافة إلى ذلك، ينشئ مثبّت Edge مستخدمًا جديدًا على نظامك باسم "apigee". Many Edge commands invoke sudo to run as the "apigee" user.

يجب أن يكون أي مستخدم يريد تشغيل جميع الأوامر الأخرى غير تلك الموضّحة أعلاه مستخدمًا لديه إذن وصول كامل إلى sudo لمستخدم "apigee". وتشمل هذه الطلبات ما يلي:

  • أوامر الأداة المساعدة apigee-service، بما في ذلك:
    • أوامر apigee-service، مثل start وstop وrestart وconfigure
    • أوامر apigee-all، مثل start وstop وrestart وconfigure

لضبط مستخدم ليحصل على إذن وصول كامل إلى مستخدم "apigee"، عليك تعديل ملف sudoers لإضافة:

installUser        ALL=(apigee)      NOPASSWD: ALL

حيث يمثّل installUser اسم المستخدم للشخص الذي يعمل مع Edge.

يجب أن يتمكن مستخدم "apigee" من الوصول إلى أي ملفات أو موارد تستخدمها أوامر Edge. ويشمل ذلك ملف ترخيص 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 RPMs والتبعيات.
  • العُقد التي لا تتصل بالإنترنت الخارجي

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

    ملاحظة: لا تستضيف Apigee جميع التبعيات التابعة لجهات خارجية في مستودعاتنا العامة. يجب تنزيل هذه التبعيات وتثبيتها من مستودعات يمكن للجميع الوصول إليها.

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

استخدام مستودع Edge محلي للحفاظ على إصدار Edge

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

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

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

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

حلّ مشاكل التبعيات في تثبيت RPM

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من ملفات RPM، ويمكن أن يكون لكل منها سلسلة خاصة من تبعيات التثبيت. يتم تحديد العديد من هذه التبعيات من خلال مكوّنات تابعة لجهات خارجية خارج نطاق تحكّم Apigee ويمكن أن تتغيّر في أي وقت. لذلك، لا تدرج المستندات رقم الإصدار الصريح لكل تبعية.

إذا كنت تُجري عملية تثبيت على جهاز يتصل بالإنترنت، يمكن للعقدة تنزيل ملفات RPM والتبعيات اللازمة. ومع ذلك، إذا كنت تثبّت من عقدة لا تتصل بالإنترنت، عليك عادةً إعداد مستودع داخلي يحتوي على جميع التبعيات اللازمة. الطريقة الوحيدة لضمان تضمين جميع التبعيات في المستودع المحلي هي محاولة التثبيت، وتحديد أي تبعيات مفقودة، ونسخها إلى المستودع المحلي حتى ينجح التثبيت.

أوامر 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.

In this guide and in the Edge Operations Guide, the root installation directory is noted as:

<inst_root>/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

تعرض الجداول التالية مكان ملفات السجلّ:

المكوّنات

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

خادم الإدارة

<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 UI

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<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

Cassandra

<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 على سبيل المثال، edge-management-server.
  • edge-mint: مكوّن لتحقيق الربح على سبيل المثال، edge-mint-management-server.
  • baas: مكوّن واجهة برمجة تطبيقات BaaS على سبيل المثال، baas-usergrid.

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

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