متطلبات التثبيت

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

متطلبات الأجهزة

يجب أن تستوفي الحد الأدنى من متطلبات الأجهزة التالية للحصول على البنية التحتية في بيئة مستوى الإنتاج. لجميع سيناريوهات التثبيت الموضحة في طوعيات التثبيت، تسرد الجداول التالية الحد الأدنى من متطلبات الأجهزة لمكونات التثبيت.

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

مكوِّن التثبيت

ذاكرة الوصول العشوائي

وحدة المعالجة المركزية (CPU)

الحد الأدنى للقرص الثابت

كاساندرا

16 غيغابايت

ثماني النواة

مساحة تخزين محلية تبلغ 250 غيغابايت مع محرك أقراص ذي حالة صلبة (SSD) أو قرص صلب (HDD) سريع يتوافق مع 2000 عملية IOPS

معالج/جهاز توجيه الرسائل على نفس الجهاز

8/16 غيغابايت

رباعي النواة

100 غيغابايت

Analytics: Postgres/Qpid على الخادم نفسه (لا يُنصَح بهذا الإجراء لمرحلة الإنتاج)

16 غيغابايت*

ثماني النواة*

سعة تخزين على الشبكة تتراوح بين 500 غيغابايت و1 تيرابايت***، يُفضَّل أن يتم ذلك مع الواجهة الخلفية SSD بسعة 1,000 IOPS أو أعلى*.

إحصاءات - Postgres مستقل

16 غيغابايت*

ثماني النواة*

سعة تخزين بالشبكة تتراوح بين 500 غيغابايت و1 تيرابايت**، ويفضل أن يتم ذلك مع الواجهة الخلفية لمحرك الأقراص ذي الحالة الصلبة، ويدعم 1000 عملية IOPS أو أعلى*.

"إحصاءات Google" - Qpid مستقل

8 غيغابايت

رباعي النواة

مساحة تخزين محلية تتراوح بين 30 و50 غيغابايت مع محرك أقراص ذي حالة صلبة أو محرك أقراص ثابتة سريع

بالنسبة إلى عمليات التثبيت التي تزيد عن 250 وحدة في الثانية، يتم استخدام محرك الأقراص الثابتة مع مساحة تخزين محلية تتيح 1000 عملية IOPS الموصى بها.

حجم قائمة انتظار Qpid التلقائي هو 20 غيغابايت. إذا كنت بحاجة إلى إضافة سعة أكبر، يمكنك إضافة المزيد عُقد Qpid.

غير ذلك (OpenLDAP وواجهة المستخدم وخادم الإدارة)

4 غيغابايت

ثنائي النواة

60 غيغابايت

† ضبط متطلبات نظام "معالج الرسائل" استنادًا إلى سرعة معالجة البيانات:

الحد الأدنى للتوصية هو 4 نوى و8 نوى لنظام معالجة بيانات عالي السرعة. يمكنك إجراء اختبارات الأداء لتحديد الحجم الأمثل لواجهات برمجة التطبيقات.

*ضبط متطلبات نظام Postgres استنادًا إلى سرعة معالجة البيانات:

  • أقل من 250 وحدة معالجة في الثانية: يمكن استخدام سعة تخزين رباعية النواة بسعة 8 غيغابايت مع سعة تخزين الشبكة المُدارة*** يتيح 1000 عملية IOPS أو أكثر
  • أكثر من 250 وحدة TPS: مساحة تخزين الشبكة المُدارة ثماني النواة تبلغ 16 غيغابايت*** تدعم 1,000 IOPS أو أعلى
  • أكثر من 1,000 وحدة تخزين في الثانية: 16 غيغابايت، سعة تخزين ثماني النواة، شبكة مُدارة* تدعم 2000 IOPS أو أعلى
  • أكثر من 2000 وحدة TPS: مساحة تخزين شبكة مُدارة بسعة 32 غيغابايت وتعمل على 16 نواة*** تدعم 2000 IOPS أو أعلى
  • أكثر من 4,000 وحدة TPS: سعة تخزين شبكة مُدارة بسعة 64 غيغابايت متاحة بسعة 4000 IOPS أو أعلى

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

(# بايت/طلب) * (الطلبات في الثانية) * (ثانية في الساعة) * (ساعات ذروة الاستخدام لكل ثانية) يوم) * (عدد الأيام في الشهر) * (أشهر الاحتفاظ بالبيانات) = وحدات البايت المطلوبة للتخزين

مثال:

(2 كيلو بايت من بيانات التحليلات لكل طلب) * 100 طلب/ثانية * 3600 ثانية/ساعة * 18 ساعة الذروة الاستخدام في اليوم * 30 يومًا في الشهر * الاحتفاظ لمدة 3 أشهر = 1,194,393,600,000 بايت أو 1194.4 غيغابايت.

*** يُنصَح بتفعيل تخزين الشبكة لقاعدة بيانات Postgresql للأسباب التالية:

  • تتيح لكم أيضًا زيادة حجم مساحة التخزين بشكل ديناميكي في حال حدوث ذلك. مطلوبة.
  • يمكن ضبط عمليات IOPS للشبكة بشكل سريع في معظم أوقات للبيئة/التخزين/الشبكة الفرعية.
  • يمكن تفعيل لقطات مستوى التخزين كجزء من الاحتفاظ بنسخة احتياطية والاسترداد الرائدة.

بالإضافة إلى ذلك، تسرد القائمة التالية متطلبات الأجهزة إذا كنت تريد تثبيت خدمات تحقيق الربح:

مكوّن مع تحقيق الربح

ذاكرة الوصول العشوائي

وحدة المعالجة المركزية (CPU)

القرص الثابت

خادم الإدارة (مع خدمات تحقيق الربح)

8 غيغابايت

رباعي النواة

60 غيغابايت

Analytics - Postgres/Qpid على الخادم نفسه

16 غيغابايت

ثماني النواة

من سعة تخزين الشبكة بين 500 غيغابايت و1 تيرابايت، ويفضل أن يتم ذلك مع الواجهة الخلفية SSD، والتي تتيح إجراء 1000 عملية IOPS أو أعلى، أو استخدم القاعدة من الجدول أعلاه.

إحصاءات - Postgres مستقل

16 غيغابايت

ثماني النواة

من سعة تخزين الشبكة بين 500 غيغابايت و1 تيرابايت، ويفضل أن يتم ذلك مع الواجهة الخلفية SSD، والتي تتيح إجراء 1000 عملية IOPS أو أعلى، أو استخدم القاعدة من الجدول أعلاه.

"إحصاءات Google" - Qpid مستقل

8 غيغابايت

رباعي النواة

مساحة تخزين محلية تتراوح بين 40 و500 غيغابايت عند استخدام محرك أقراص ذي حالة صلبة أو محرك أقراص ثابتة سريع
بالنسبة إلى عمليات التثبيت التي تزيد عن 250 وحدة في الثانية، يتم استخدام محرك الأقراص الثابتة مع مساحة تخزين محلية تتيح 1000 عملية IOPS الموصى بها.

في ما يلي قائمة بمتطلبات الأجهزة إذا كنت تريد تثبيت واجهة برمجة التطبيقات BaaS:

مكوِّن واجهة برمجة التطبيقات BaaS

ذاكرة الوصول العشوائي

وحدة المعالجة المركزية (CPU)

القرص الثابت

ElasticSearch*

8 غيغابايت

رباعي النواة

60 - 80 غيغابايت

حزمة BaaS من واجهة برمجة التطبيقات *

8 غيغابايت

رباعي النواة

60 - 80 غيغابايت

بوابة BaaS لواجهة برمجة التطبيقات

1 غيغابايت

ثنائي النواة

20 غيغابايت

كاساندرا (اختياري - عادةً ما تستخدم نفس مجموعة Cassandra لكل من Edge وخدمات BaaS لواجهة برمجة التطبيقات)

16 غيغابايت

ثماني النواة

مساحة تخزين محلية تبلغ 250 غيغابايت مع محرك أقراص ذي حالة صلبة (SSD) أو قرص صلب (HDD) سريع يتوافق مع 2000 عملية IOPS

* يمكنك تثبيت ElasticSearch وBaaS Stack على نفس العقدة. إذا فعلت ذلك، تهيئة ElasticSearch لاستخدام ذاكرة سعتها 4 غيغابايت (افتراضي). إذا كان تطبيق ElasticSearch مثبتًا العقدة الخاصة بها، ثم إعدادها لاستخدام ذاكرة بسعة 6 جيجا بايت.

ملاحظة:

  • إذا لم يكن نظام الملفات الجذر كبيرًا بما يكفي للتثبيت، ننصحك وضع البيانات على قرص أكبر.
  • في حال تثبيت إصدار قديم من Apigee Edge for Private Cloud على الجهاز، تأكَّد من حذف المجلد /tmp/java قبل إجراء عملية تثبيت جديدة.
  • يحتاج المجلد المؤقت /tmp على مستوى النظام إلى أذونات تنفيذ من أجل لبدء تشغيل كاساندرا.
  • في حال إنشاء واجهة برمجة تطبيقات المستخدم قبل التثبيت، تأكَّد من يوجد “/home/apigee” كدليل رئيسي ويمتلكه "apigee:apigee".

نظام التشغيل والجهة الخارجية متطلبات البرامج

تم اختبار إرشادات التثبيت هذه وملفات التثبيت المُقدَّمة على أنظمة التشغيل والبرامج الخارجية المُدرجة هنا: https://apigee.com/docs/api-services/reference/supported-software.

إنشاء مستخدم apigee

يؤدي إجراء التثبيت إلى إنشاء مستخدم نظام Unix باسم "apigee". أدلة Edge الملفات مملوكة من قِبل "apigee"، كما هي الحال مع عمليات Edge. هذا يعني أن مكونات Edge تعمل "apigee" المستخدم. إذا لزم الأمر، يمكنك تشغيل المكونات كمستخدم مختلف. الاطّلاع على "ربط جهاز التوجيه إلى منفذ محمي" في تثبيت مكونات Edge على كمثال.

دليل التثبيت

بشكل تلقائي، يكتب المثبِّت جميع الملفات في دليل /opt/apigee. لا يمكنك تغيير هذا الإعداد. موقع الدليل. بينما لا يمكنك تغيير هذا الدليل، يمكنك إنشاء رابط رمزي لتعيين /opt/apigee إلى موقع آخر، كما هو موضح أدناه.

في التعليمات الواردة في هذا الدليل، تتم الإشارة إلى دليل التثبيت باسم /<inst_root>/apigee، حيث تكون /<inst_root> هي /opt تلقائيًا.

إنشاء رابط رمزي من /opt/apigee

قبل إنشاء الرابط الرمزي، يجب أولاً إنشاء مستخدم ومجموعة باسم "apigee". هذا هو نفس المجموعة والمستخدم الذي تم إنشاؤه بواسطة أداة تثبيت Edge.

لإنشاء الرابط الرمزي، نفِّذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.17.01.sh. يجب تنفيذ كل هذه الخطوات كجذر:

  1. إنشاء "واجهة برمجة تطبيقات" المستخدم والمجموعة:
    &gt; groupadd -r apigee
    &gt; useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "مستخدم نظام Apigee" apigee
  2. أنشِئ رابطًا رمزيًا من /opt/apigee إلى التثبيت المطلوب. الجذر:
    &gt; ln -Ts /srv/myInstallDir /opt/apigee
    حيث يكون /srv/myInstallDir هو الموقع المطلوب لشبكة Edge الملفات.
  3. تغيير ملكية جذر التثبيت والرابط الرمزي إلى "apigee" المستخدم:
    &gt; تشون -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

عليك تثبيت إصدار متوافق من Java1.8 على كل جهاز قبل عملية التثبيت. يتم إدراج ملفات JDK المتوافقة هنا:

https://apigee.com/docs/api-services/reference/supported-software

تأكَّد من أنّ JAVA_HOME يشير إلى إلى جذر JDK للمستخدم الذي يقوم بالتثبيت.

SELinux

بناءً على إعدادات SELinux، يمكن أن تواجه Edge مشكلات في التثبيت والبدء مكونات الحافة. إذا لزم الأمر، يمكنك تعطيل SELinux أو تعيينه على الوضع المتساهِل أثناء ثم إعادة تمكينه بعد التثبيت. راجع تثبيت أداة إعداد واجهة برمجة التطبيقات Edge لمعرفة المزيد.

إعدادات الشبكة

ننصحك بمراجعة إعدادات الشبكة قبل التثبيت. أداة التثبيت أن جميع الأجهزة تحتوي على عناوين IP ثابتة. استخدم الأوامر التالية للتحقق من صحة الإعداد:

  • تعرض hostname الاسم من الجهاز
  • يعرض hostname -i عنوان IP. لعنوان اسم المضيف الذي يمكن معالجته من أجهزة أخرى.

اعتمادًا على نوع نظام التشغيل وإصداره، قد تضطر إلى تعديل /etc/hosts و/etc/sysconfig/network إذا لم يكن اسم المضيف بشكل صحيح. للحصول على مزيد من المعلومات، يمكنك مراجعة وثائق نظام التشغيل المحدد.

أغلفة TCP

ويمكن أن تحظر برامج أغلفة TCP الاتصال ببعض المنافذ وقد تؤثر في بروتوكول OpenLDAP وPostgres تركيب "كاساندرا". على هذه العُقد، ضَع علامة في المربّع /etc/hosts.allow و/etc/hosts.deny لكي التأكد من عدم وجود قيود على المنفذ على برامج OpenLDAP وPostgres وCassandra المطلوبة متعددة.

أجهزة iptables

تحقَّق من عدم توفّر سياسات iptables تمنع الاتصال بين العُقد في منافذ Edge المطلوبة. إذا لزم الأمر، يمكنك إيقاف iptables أثناء التثبيت باستخدام :

> sudo /etc/init.d/iptables stop

على الإصدار 7.x من نظام التشغيل CentOS:

> systemctl stop firewalld

التأكد من قدرة جهاز توجيه الحافة الوصول إلى /etc/rc.d/init.d/functions

تستخدم عُقد شبكة Edge Router وBaaS Portal جهاز توجيه Nginx، وتتطلب إذنًا بالقراءة. إلى /etc/rc.d/init.d/functions.

إذا كانت العملية الأمنية تتطلب منك تعيين أذونات على /etc/rc.d/init.d/functions، لم يتم تعيينها على 700 وإلا سيفشل جهاز التوجيه في البدء. يمكن ضبط الأذونات على 744 للسماح إذن الوصول لقراءة /etc/rc.d/init.d/functions.

كاساندرا

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

تضبط "كاساندرا" حجم كومة الذاكرة المؤقتة في Java تلقائيًا استنادًا إلى الذاكرة المتاحة. لمزيد من المعلومات، راجع ضبط Java الموارد عند انخفاض الأداء أو استهلاك الذاكرة بشكل كبير

بعد تثبيت Edge for Private Cloud، يمكنك التحقّق من ضبط إعدادات Cassandra. بشكل صحيح عن طريق فحص /&lt;inst_root&gt;/apigee/apigee-cassandra/conf/cassandra.yaml الملف. على سبيل المثال، تأكَّد من أنّ النص البرمجي للتثبيت Edge for Private Cloud يضبط ما يلي المواقع:

  • cluster_name
  • initial_token
  • التقسيم
  • البذور
  • listen_address
  • rpc_address
  • مذكرات

تحذير: لا تعدِّل هذا الملف.

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

بعد تثبيت Edge، يمكنك ضبط إعدادات قاعدة بيانات PostgreSQL التالية بناءً على مقدار ذاكرة الوصول العشوائي المتاحة على نظامك:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

لضبط هذه القيم:

  1. تعديل خصائص postgresql:
    &gt; vi /&lt;inst_root&gt;/apigee/customer/application/postgresql.properties

    إذا لم يكن الملف متوفّرًا، أنشئه.
  2. اضبط الخصائص المدرَجة أعلاه.
  3. احفظ تعديلاتك.
  4. أعِد تشغيل قاعدة بيانات PostgreSQL:
    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql إعادة التشغيل

حدود النظام

تأكد من تعيين حدود النظام التالية على Cassandra ومعالج الرسائل العُقد:

  • في عقد Cassandra، عيّن حدودًا ثابتة وصعبة لفتح القفل، ومساحة العنوان (as) لـ مستخدم تثبيت (الإعداد التلقائي "apigee") في /etc/security/limits.d/90-apigee-edge-limits.conf كما هو موضح أدناه:
    مذكرة ناعمة غير محدودة
    أمر apigee Hard Memlock غير محدود
    apigee soft nofile 32768
    أمر apigee hard nofile 65536
    apigee soft كغير محدود
    تحدي شديد لا حدود له

  • في عُقد معالج الرسائل، اضبط الحد الأقصى لعدد أدوات وصف الملفات المفتوحة على 64 كيلوبايت في /etc/security/limits.d/90-apigee-edge-limits.conf كما هو موضح أدناه:
    apigee soft nofile 32768
    أمر apigee rock 65536


    يمكنك رفع هذا الحدّ إذا لزم الأمر. فعلى سبيل المثال، إذا كان لديك عدد كبير من الزيارات الملفات في أي وقت.

jsvc

"jsvc" هو شرط أساسي لاستخدام واجهة برمجة التطبيقات BaaS. يتم تثبيت الإصدار 1.0.15-dev عند التثبيت وتقديم خدمة BaaS لواجهة برمجة التطبيقات.

خدمات أمان الشبكات (NSS)

خدمات أمان الشبكات (NSS) هي مجموعة من المكتبات التي تدعم تطوير تطبيقات العميل والخادم المزودين بالأمان. يجب التأكّد من تثبيت NSS. أو الإصدار 3.19 أو إصدار أحدث.

للتحقق من الإصدار الحالي:

> yum info nss

لتحديث NSS:

> yum update nss

يمكنك الاطّلاع على هذه المقالة من RedHat. لمزيد من المعلومات.

إيقاف بحث نظام أسماء النطاقات على IPv6 عند استخدام البرنامج الخفي لذاكرة التخزين المؤقت (NSCD)

إذا قمت بتثبيت برنامج NSCD (البرنامج الخفي لذاكرة التخزين المؤقت لخدمة الاسم) وتمكينه، فإن معالِجات الرسائل إجراء عمليتي بحث لنظام أسماء النطاقات: إحداهما لبروتوكول IPv4 والأخرى لبروتوكول IPv6. يجب إيقاف بحث نظام أسماء النطاقات على IPv6 عند استخدام NSCD.

لإيقاف بحث نظام أسماء النطاقات على IPv6:

  1. في كل عقدة "معالج الرسائل"، عدِّل /etc/nscd.conf.
  2. اضبط السمة التالية:
    عدم تفعيل مضيفي ذاكرة التخزين المؤقت

إيقاف IPv6 على Google Cloud منصة RedHat/CentOS 7

في حال تثبيت Edge على RedHat 7 أو CentOS 7 على Google Cloud Platform، يجب يجب إيقاف IPv6 على جميع عُقد Qpid.

للحصول على تعليمات حول إصدار نظام التشغيل المستخدَم على جهازك، يمكنك الاطّلاع على وثائق RedHat أو CentOS وتعطيل IPv6.

AWS AMI

في حال تثبيت Edge على صورة جهاز AWS Amazon Machine (AMI) لنظام التشغيل Red Hat Enterprise Linux 7.x، يجب أولاً تشغيل الأمر التالي:

> yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

الأدوات

أداة التثبيت تستخدم أدوات UNIX التالية في الإصدار العادي على النحو المقدَّم من EL5 أو المشروع EL6.

awk

تجربة

lua-socket

دورة في الدقيقة

فك الضغط

الاسم الأساسي

Grep

الأمر ls الدليل

rpm2cpio

إضافة مستخدم

تحطيم

اسم المضيف

أدوات الشبكة

درهم إماراتي

wc

bc

id

Perl (من Procps)

sudo

wget

curl

ليبايو

pgrep (من Procps)

القطران

xerces-c

سايروس ساسل
libdb-cxx
ps tr لذيذ

التاريخ

أفعال ليبيب

pwd

رقم uuid

chkconfig

اسم dirname
librdmacm
python uname
echo
libxslt

ملاحظة:

  • يمكنك العثور على الملف التنفيذي للأداة "useradd" في /usr/sbin وبالنسبة إلى chkconfig في /sbin.
  • باستخدام إذن الوصول إلى برنامج sudo، يمكنك الوصول إلى بيئة المستخدم الذي يطلب البيانات، على سبيل المثال، سوف تسميها عادةً "sudo <command> أو “sudo PATH=$PATH:/usr/sbin:/sbin <command>”.
  • التأكد من تثبيت أداة "التصحيح" قبل حزمة الخدمة (التصحيح) التثبيت.

ntpdate – يُنصَح بمزامنة وقت الخوادم. في حال حذف لم تتم تهيئتها بالفعل، فيمكن أن تخدم الأداة "ntpdate" هذا الغرض، الذي يتحقق ما إذا كانت الخوادم متزامنة للوقت. يمكنك استخدام "yum install ntp" لتثبيت الأخرى. ويعد هذا مفيدًا بشكل خاص لتكرار إعدادات OpenLDAP. لاحظ أنه يتم إعداد الخادم المنطقة الزمنية بالتوقيت العالمي المنسق (UTC).

openldap 2.4 - يتطلب التثبيت في المؤسسة الإصدار OpenLDAP 2.4. في حال حذف أن خادمك متصل بالإنترنت، عندئذٍ يتم تنزيل وتثبيت Edge البرمجي على خادمك OpenLDAP. إذا لم يكن خادمك متصلاً بالإنترنت، ينبغي لك التأكد من أن OpenLDAP "مثبت" بالفعل قبل تشغيل النص البرمجي لتثبيت Edge. على RHEL/CentOS، يمكنك تشغيل "yum install openldap-clients openldap-servers&quot; لتثبيت بروتوكول OpenLDAP.

بالنسبة إلى عمليات التثبيت التي تتضمّن 13 مضيفًا وعمليات التثبيت التي تتضمّن 12 مضيفًا مع مركزَي بيانات، يجب توفير ما يلي: النسخ المتماثل لـ OpenLDAP نظرًا لوجود عُقد متعددة تستضيف OpenLDAP.

جدران الحماية والمضيفات الافتراضية

عادةً ما يتم تحميل مصطلح "افتراضي" بشكل زائد في مجال تكنولوجيا المعلومات، وبالتالي نشر Apigee Edge for Private Cloud والمضيفين الافتراضيين للتوضيح، هناك نوعان أساسيان لاستخدامات مصطلح "افتراضي":

  • الأجهزة الافتراضية (VM): غير مطلوب، ولكن تستخدم بعض عمليات النشر تكنولوجيا الأجهزة الافتراضية. لإنشاء خوادم معزولة لمكونات Apigee. يمكن لمضيفي الأجهزة الافتراضية، مثل المضيفين المادي، وواجهات الشبكات والجدران النارية.
  • المضيفات الافتراضية: نقاط نهاية الويب، مماثلة لمضيف Apache الافتراضي.

يمكن أن يكشف الموجه في جهاز افتراضي عن مضيفين افتراضيين متعددين (طالما يختلفون عن بعضهم البعض في الاسم المستعار لمضيفه أو في منفذ الواجهة).

وكمثال على التسمية، قد يقوم خادم مادي واحد "A" بتشغيل جهازين افتراضيين، باسم "VM1" و"VM2". لنفترض أن الجهاز الافتراضي VM1 يعرض شبكة إيثرنت افتراضية الواجهة، التي يُطلق عليها اسم eth0 داخل الجهاز الافتراضي الذي يتم تخصيص عنوان IP له 111.111.111.111 من خلال المحاكاة الافتراضية آلات أو خادم بروتوكول التهيئة الآلية للمضيفين (DHCP) للشبكة؛ ثم نفترض أن VM2 تعرض واجهة Ethernet افتراضية أيضًا يُسمى eth0 ويتم تعيين عنوان IP له 111.111.111.222.

قد يكون لدينا جهاز توجيه Apigee يعمل في كل من الجهازين الافتراضيين. أجهزة التوجيه تكشف عن المضيف الظاهري نقاط النهاية كما في هذا المثال الافتراضي:

يعرض جهاز توجيه Apigee في VM1 ثلاثة مضيفات افتراضية على واجهة eth0 (التي تحتوي على بعض عنوان IP محدد)، وapi.mycompany.com:80، وapi.mycompany.com:443، وtest.mycompany.com:80.

يعرض جهاز التوجيه في VM2 api.mycompany.com:80 (الاسم والمنفذ نفسيهما). الكشف عنها بواسطة VM1).

قد يحتوي نظام تشغيل المضيف الفعلي على جدار حماية للشبكة. فإن جدار الحماية هذا لتمرير حركة بيانات TCP المرتبطة بالمنافذ التي يتم الكشف عنها على الأجهزة الافتراضية الواجهات (111.111.111.111:{80, 443} و111.111.111.222:80). بالإضافة إلى ذلك، قد يوفّر نظام تشغيل الأجهزة الافتراضية جدار الحماية الخاص به على واجهة eth0، ويجب أن توفّر هذه الأجهزة أيضًا جدار حماية. يسمح باتصال حركة مرور المنفذين 80 و443.

المسار الأساسي هو المكوّن الثالث المُستخدَم في توجيه طلبات البيانات من واجهة برمجة التطبيقات إلى خوادم وكيلة مختلفة لواجهة برمجة التطبيقات. التي ربما تكون قد نشرتها يمكن لحِزم الخادم الوكيل لواجهة برمجة التطبيقات مشاركة نقطة نهاية إذا كان لها والمسارات الأساسية. على سبيل المثال، يمكن تعريف أحد المسارات الأساسية على أنه http://api.mycompany.com:80/ وآخر هو http://api.mycompany.com:80/salesdemo.

وفي هذه الحالة، ستحتاج إلى جهاز موازنة الحمل أو مدير حركة بيانات من نوع ما يقسم http://api.mycompany.com:80/ عدد الزيارات بين عنواني IP (111.111.111.111 على VM1 و111.111.111.222 على الجهاز الافتراضي 2). هذه الدالة هي الخاصة بتثبيتك، وتهيئها مجموعة الشبكات المحلية.

ويتم ضبط المسار الأساسي عند نشر واجهة برمجة تطبيقات. من المثال أعلاه، يمكنك نشر اثنين من واجهات برمجة التطبيقات، mycompany وtestmycompany، للمؤسسة mycompany-org باستخدام المضيف الذي يحتوي على الاسم المستعار المضيف لـ api.mycompany.com وتم تعيين المنفذ على 80. في حال عدم الإفصاح عن Basepath في عملية النشر، لن يعرف الموجه واجهة برمجة التطبيقات التي يجب إرسال الطلبات الواردة بها إليه.

ومع ذلك، إذا نشرت واجهة برمجة التطبيقات testmycompany باستخدام عنوان URL الأساسي /salesdemo، ثم إمكانية وصول المستخدمين واجهة برمجة التطبيقات هذه باستخدام http://api.mycompany.com:80/salesdemo. إذا كنت نشر واجهة برمجة التطبيقات mycompany باستخدام عنوان URL الأساسي، ثم دخول المستخدمين إلى واجهة برمجة التطبيقات من خلال عنوان URL http://api.mycompany.com:80/.

متطلبات منفذ Edge

الحاجة إلى إدارة جدار الحماية لا تقتصر على المضيفات الظاهرية فحسب؛ كل من الجهاز الافتراضي والمضيف الفعلي أن تسمح جدران الحماية بحركة مرور المنافذ التي تحتاجها المكونات للتواصل مع كل آخر.

توضح الصورة التالية متطلبات المنافذ لكل مكون من مكونات Edge:

ملاحظات على هذا المخطّط البياني:

  • *يجب فتح المنفذ 8082 في معالج الرسائل فقط للوصول إليه بواسطة جهاز التوجيه عند قم بتهيئة TLS/SSL بين جهاز التوجيه ومعالج الرسائل. في حال عدم ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) بين جهاز التوجيه ومعالج الرسائل، أيهما الإعداد التلقائي، لا يزال المنفذ 8082 مطلوبًا مفتوحة في معالج الرسائل لإدارة المكوِّن، غير أن جهاز التوجيه لا يتطلب الوصول إليها.
  • المنافذ التي تبدأ بـ "M" هي منافذ تُستخدم لإدارة المكوِّن ويجب فتحها على مكون من مكونات الوصول بواسطة خادم الإدارة.
  • تتطلب المكونات التالية الوصول إلى المنفذ 8080 على خادم الإدارة: جهاز التوجيه، معالج الرسائل، وواجهة المستخدم، وPostgres، وQpid.
  • يجب أن يفتح معالج الرسائل المنفذ 4528 كمنفذ الإدارة الخاص به. إذا كان لديك عدة ينبغي أن تكون جميعها قادرة على الوصول إلى بعضها البعض عبر المنفذ 4528 (يُشار إليه باسم سهم حلقة في الرسم التخطيطي أعلاه للمنفذ 4528 في معالج الرسائل). إذا كان لديك عدة لمراكز البيانات، يجب أن تكون إمكانية الوصول إلى المنفذ متاحة من قِبل جميع معالِجات الرسائل في جميع مراكز البيانات.
  • يمكنك فتح المنفذ 4527 على جهاز التوجيه للوصول إلى أي رسالة على الرغم من أنّه غير مطلوب. المعالج. أو قد تظهر لك رسائل خطأ في ملفات سجلّ معالج الرسائل.
  • يجب أن يفتح جهاز التوجيه المنفذ 4527 كمنفذ الإدارة الخاص به. إذا كانت لديك أجهزة توجيه متعددة، أن تكون جميعها قادرة على الوصول إلى بعضها البعض عبر المنفذ 4527 (يشار إليه بواسطة سهم التكرار في أعلاه للمنفذ 4527 على جهاز التوجيه).
  • تتطلب واجهة مستخدم Edge الوصول إلى جهاز التوجيه، على المنافذ التي تعرضها الخوادم الوكيلة لواجهة برمجة التطبيقات، لدعم زر إرسال في أداة التتبُّع.
  • يتطلب خادم الإدارة الوصول إلى منفذ JMX على كاساندرا العُقد.
  • يمكن ضبط الوصول إلى منافذ JMX على طلب اسم مستخدم/كلمة مرور. راجِع كيفية المراقبة لمزيد من المعلومات.
  • يمكنك اختياريًا ضبط الوصول إلى بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) لاتصالات معيّنة يمكنها استخدام منافذ مختلفة. يمكنك الاطّلاع على TLS/SSL للحصول على أخرى.
  • في حال ضبط عقدتَين من قِبل Postgres لاستخدام النسخ المتماثل لوضع الاستعداد الرئيسي، يجب فتح المنفذ 22. على كل عقدة للوصول إلى ssh. يمكنك اختياريًا فتح المنافذ على العُقد الفردية للسماح وSSH.
  • يمكنك ضبط واجهة مستخدم خادم الإدارة وEdge لإرسال الرسائل الإلكترونية من خلال بروتوكول SMTP خارجي. الخادم. وإذا فعلت ذلك، فيجب عليك التأكد من أنه يمكن لخادم الإدارة وواجهة المستخدم الوصول إلى على خادم SMTP. بالنسبة إلى بروتوكول نقل البريد البسيط (SMTP) الذي لا يستخدم بروتوكول أمان طبقة النقل (TLS)، يكون رقم المنفذ عادةً 25. بالنسبة إلى تفعيل بروتوكول أمان طبقة النقل (TLS) SMTP، غالبًا ما يكون 465، لكن تحقق مع موفر SMTP.

يوضح الجدول أدناه المنافذ التي يجب فتحها في جدران الحماية، بواسطة مكون Edge:

المكوّن

المنفذ

الوصف

منافذ HTTP العادية

80، 443

HTTP بالإضافة إلى أي منافذ أخرى تستخدمها للمضيفات الافتراضية

خادم الإدارة

8080

منفذ طلبات البيانات من واجهة برمجة التطبيقات لإدارة Edge تتطلب هذه المكونات الوصول إلى المنفذ 8080 على خادم الإدارة: Router، ومعالج الرسائل، وUI وPostgres، وQpid.

1099

منفذ JMX

4526

لذاكرة التخزين المؤقت ومكالمات الإدارة الموزعة

واجهة مستخدم الإدارة

9000

منفذ وصول المتصفّح إلى واجهة مستخدم الإدارة

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

8998

منفذ معالج الرسائل للاتصالات من جهاز التوجيه

8082

منفذ الإدارة الافتراضي لمعالج الرسائل ويجب فتحه على المكوِّن الوصول إليها من خلال خادم الإدارة.

إذا ضبطت بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) بين جهاز التوجيه ومعالج الرسائل، اللذين يستخدمهما جهاز التوجيه لإجراء الفحوصات الصحية على معالج الرسائل.

1101

منفذ JMX

4528

لذاكرة التخزين المؤقت واستدعاءات الإدارة الموزعة بين معالجات الرسائل، الاتصالات من جهاز التوجيه

جهاز التوجيه

8081

منفذ الإدارة التلقائي لجهاز التوجيه ويجب فتحه على المكوِّن للوصول إليه بواسطة خادم الإدارة.

4527

لذاكرة التخزين المؤقت ومكالمات الإدارة الموزعة

15999

منفذ فحص الحالة الصحية يستخدم جهاز موازنة الحمل هذا المنفذ لتحديد ما إذا كان جهاز التوجيه المتوفرة.

للحصول على حالة جهاز التوجيه، يرسل جهاز موازنة الحمل طلبًا إلى المنفذ 15999 على الموجه:

> curl -v http://<routerIP>:15999/v1/servers/self/reachable

فإذا كان من الممكن الوصول إلى جهاز التوجيه، سيعرض الطلب HTTP 200.

59001

المنفذ المستخدم لاختبار تثبيت Edge بواسطة الأداة المساعدة apigee-validate. تتطلب هذه الأداة الوصول إلى المنفذ 59001 على جهاز التوجيه. راجِع اختبار التثبيت للتعرّف على مزيد من المعلومات عن المنفذ 59001.

ZooKeeper

2181

تستخدمه مكونات أخرى مثل خادم الإدارة وجهاز التوجيه ومعالج الرسائل وما إلى ذلك في

2888، 3888

يتم استخدامه داخليًا من قِبل ZooKeeper لمجموعة ZooKeeper (المعروفة باسم مجموعة ZooKeeper) التواصل

كاساندرا

7000، 9042، 9160

منافذ Apache Cassandra للاتصال بين عُقد Cassandra وللوصول عن طريق مكونات Edge الأخرى.

7199

منفذ JMX يجب أن يكون الوصول إليها متاحًا من خلال خادم الإدارة.

Qpid

5672

يُستخدم للاتصالات من جهاز التوجيه ومعالج الرسائل إلى خادم Qpid.

8083

منفذ الإدارة التلقائي على خادم Qpid ويجب فتحه على المكوِّن الوصول إليها من خلال خادم الإدارة.

1102

منفذ JMX

4529

لذاكرة التخزين المؤقت ومكالمات الإدارة الموزعة

Postgres

5432

يستخدم للاتصال من Qpid/Management Server إلى Postgres

8084

منفذ الإدارة التلقائي على خادم Postgres ويجب فتحه على المكوِّن للوصول بواسطة خادم الإدارة.

1103

منفذ JMX

4530

لذاكرة التخزين المؤقت ومكالمات الإدارة الموزعة

22

في حالة تهيئة عُقدتين في Postgres لاستخدام النسخ الاحتياطي في وضع الاستعداد الرئيسي، يجب فتح المنفذ 22 في كل عقدة للوصول إلى SSH.

LDAP

10389

OpenLDAP

SmartDocs

59002

المنفذ في جهاز توجيه Edge الذي يتم إرسال طلبات صفحة Smart Docs إليه.

يعرض الجدول التالي المنافذ نفسها، مدرَجة رقميًا مع المصدر والوجهة. المكونات:

رقم المنفذ

الغرض

المكوّن المصدر

مكوّن الوجهة

<اسم المنفذ المضيف الافتراضي#>

HTTP بالإضافة إلى أي منافذ أخرى تستخدمها لعدد زيارات طلبات البيانات من واجهة برمجة التطبيقات للمضيف الظاهري. المنفذان 80 و443 الأكثر استخدامًا؛ بإمكان جهاز توجيه الرسائل إنهاء اتصالات بروتوكول أمان طبقة النقل/طبقة المقابس الآمنة.

برنامج خارجي (أو جهاز موازنة الحمل)

أداة استماع على جهاز توجيه الرسائل

من 1099 إلى 1103

إدارة JMX

برنامج JMX

خادم الإدارة (1099)

معالج الرسائل (1101)

Qpid Server (1102)

Postgres Server (1103)

2181

التواصل مع عميل Zookeeper

خادم الإدارة

جهاز التوجيه

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

خادم Qpid

خادم Postgres

حارس حديقة حيوان

2888 و3888

إدارة عمليات داخلية في Zookeeper

حارس حديقة حيوان

حارس حديقة حيوان

4526

منفذ إدارة استدعاء إجراء عن بُعد (RPC)

خادم الإدارة

خادم الإدارة

4527 منفذ إدارة استدعاء إجراء عن بُعد لذاكرة التخزين المؤقت الموزعة ومكالمات الإدارة، والاتصالات بين أجهزة التوجيه

خادم الإدارة

جهاز التوجيه

جهاز التوجيه

4528

لاستدعاءات ذاكرة التخزين المؤقت الموزعة بين معالجات الرسائل، وللتواصل مِنْ جِهَازِ التَّوْجِيهِ الْمَوْجُودْ

خادم الإدارة

جهاز التوجيه

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

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

4529 منفذ إدارة استدعاء إجراء عن بُعد لذاكرة التخزين المؤقت الموزعة ومكالمات الإدارة خادم الإدارة خادم Qpid
4530 منفذ إدارة استدعاء إجراء عن بُعد لذاكرة التخزين المؤقت الموزعة ومكالمات الإدارة خادم الإدارة خادم Postgres

5432

عميل Postgres

خادم Qpid

Postgres

5672

يتم استخدامه لإرسال الإحصاءات من جهاز التوجيه ومعالج الرسائل إلى Qpid.

جهاز التوجيه

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

خادم Qpid

7,000

اتصالات بين العُقد من "كاساندرا"

كاساندرا

عقدة كاساندرا أخرى

7199

إدارة JMX. يجب أن تكون مفتوحة للوصول على عقدة Cassandra من خلال "الإدارة". الخادم.

عميل JMX

كاساندرا

8080

منفذ Management API

برامج Management API

خادم الإدارة

8081 إلى 8084

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

برامج Management API

Router (8081)

معالج الرسائل (8082)

Qpid Server (8083)

Postgres Server (8084)

8998

الاتصال بين جهاز التوجيه ومعالج الرسائل

جهاز التوجيه

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

9,000

منفذ واجهة المستخدم التلقائي لإدارة Edge

المتصفح

خادم واجهة مستخدم الإدارة

9042

النقل الأصلي لـ CQL

جهاز التوجيه

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

خادم الإدارة

كاساندرا

9160

عميل التوفير "كاساندرا"

جهاز التوجيه

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

خادم الإدارة

كاساندرا

10389

منفذ LDAP

خادم الإدارة

OpenLDAP

15999

منفذ فحص الحالة الصحية يستخدم جهاز موازنة الحمل هذا المنفذ لتحديد ما إذا كان جهاز التوجيه المتوفرة.

جهاز موازنة الحمل جهاز التوجيه
59,001 المنفذ الذي تستخدمه أداة apigee-validate للاختبار تثبيت Edge apigee-validate جهاز التوجيه

59002

منفذ جهاز التوجيه الذي يتم من خلاله إرسال طلبات صفحة Smart Docs

SmartDocs

جهاز التوجيه

يعمل معالج الرسائل على إبقاء مجموعة اتصال مخصصة مفتوحة لـ "كاساندرا"، والتي يتم ضبطها على عدم انتهاء المهلة أبدًا. عندما يكون جدار حماية بين معالج الرسائل وخادم Cassandra، أن يؤدي جدار الحماية إلى إنهاء الاتصال. ومع ذلك، فإن معالج الرسائل غير مصمم إعادة إنشاء اتصالات مع "كاساندرا".

لمنع هذا الموقف، تنصح Apigee بأن يتم ضبط خادم Cassandra ومعالج الرسائل والموجهات في الشبكة الفرعية نفسها بحيث لا يشارك جدار حماية في نشر هذه والمكونات.

إذا كان جدار الحماية يقع بين جهاز التوجيه ومعالِجات الرسائل، وتم ضبط مهلة Tcp على عدم نشاطه، توصياتنا هي:

  1. اضبط net.ipv4.tcp_keepalive_time = 1800 في إعدادات sysctl على نظام التشغيل Linux، حيث يجب أن يكون الرقم 1800 أقل من جدار الحماية غير النشط مهلة tcp. وينبغي أن يبقي هذا الإعداد الاتصال في حالة مستقرة بحيث لا يقطع جدار الحماية الاتصال.
  2. في كل معالِجات الرسائل، عدِّل /&lt;inst_root&gt;/apigee/customer/application/message-processor.properties لإضافة الخاصية التالية. إذا لم يكن الملف متوفّرًا، أنشئه.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  3. إعادة تشغيل معالج الرسائل:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-message-processor
  4. على جميع أجهزة التوجيه، عدِّل /&lt;inst_root&gt;/apigee/customer/application/router.properties لإضافة الخاصية التالية. إذا لم يكن الملف متوفّرًا، أنشئه.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  5. إعادة تشغيل جهاز التوجيه:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-router

في حال تثبيت التهيئة المجمّعة حسب 12 مضيفًا مع مركزي بيانات، تأكد من يمكن للعُقد في مركزي البيانات الاتصال عبر المنافذ الموضحة أدناه:

متطلبات منفذ BaaS لواجهة برمجة التطبيقات

إذا اختَرت تثبيت BaaS لواجهة برمجة التطبيقات، يمكنك إضافة مكوّنات بوابة BaaS لواجهة برمجة التطبيقات وبوابة BaaS لواجهة برمجة التطبيقات. تستخدم هذه المكوّنات المنافذ الموضحة في الشكل أدناه:

ملاحظات على هذا المخطّط البياني:

  • لا تُجري بوابة BaaS API الطلبات مباشرةً إلى عقدة حزمة BaaS. عندما يختار مطور البرامج تسجيل الدخول إلى "البوابة"، يتم تنزيل تطبيق "البوابة" على المتصفح. يتم تشغيل تطبيق "بوابة" في يقوم المتصفح بعد ذلك بإجراء طلبات إلى عُقد حزمة BaaS.
  • إنّ تثبيت إصدار BaaS لواجهة برمجة التطبيقات يستخدم جهاز موازنة الحمل بين عقدة بوابة BaaS الخاصة بواجهة برمجة التطبيقات. وعُقد واجهة برمجة التطبيقات BaaS Stack. عند إعداد "البوابة" وعند إجراء طلبات بيانات من واجهة برمجة التطبيقات BaaS، عليك حدد عنوان IP أو اسم نظام أسماء النطاقات لجهاز موازنة الحمل، وليس لعُقد الحزمة.
  • يجب أن تفتح جميع عُقد حزمة التكديس المنفذ 2551 للوصول من جميع عقد الحزمة الأخرى (يُشار إليها بواسطة سهم تكرار حلقي في الرسم التخطيطي أعلاه للمنفذ 2551 على عُقد الحزمة). إذا كانت لديك بيانات متعددة بالنسبة إلى المنفذ، يجب أن تتوفّر إمكانية الوصول إلى المنفذ من جميع عُقد الحزم في جميع مراكز البيانات.
  • يجب إعداد جميع عُقد حزمة Baas Stack لإرسال الرسائل الإلكترونية من خلال خادم SMTP خارجي. بالنسبة SMTP بدون بروتوكول أمان طبقة النقل (TLS)، يكون رقم المنفذ عادةً 25. بالنسبة إلى بروتوكول نقل البريد البسيط (SMTP) الذي تم تفعيل بروتوكول أمان طبقة النقل (TLS)، يكون غالبًا 465، ولكن يُرجى التحقق مع مزوّد SMTP.
  • يمكن تخصيص عُقد Cassandra لنظام BaaS لواجهة برمجة التطبيقات، أو يمكن مشاركتها مع Edge.

يوضح الجدول أدناه المنافذ التلقائية التي يجب فتحها في جدران الحماية، حسب المكوّن:

المكوّن

المنفذ

الوصف

بوابة واجهة برمجة التطبيقات BaaS

9000

منفذ لواجهة مستخدم BaaS لواجهة برمجة التطبيقات

حزمة BaaS من واجهة برمجة التطبيقات

8080

المنفذ الذي يتم استلام طلب البيانات من خلاله

2551

منفذ للاتصال بين جميع عُقد المكدس. يجب أن تكون متاحة من خلال جميع الحزم الأخرى العُقد في مستودع البيانات.

إذا كان لديك عدة مراكز بيانات، يجب أن تتوفّر إمكانية الوصول إلى المنفذ من جميع عُقد تكديس في جميع مراكز البيانات.

ElasticSearch

9200 إلى 9400

للتواصل مع واجهة برمجة التطبيقات BaaS Stack وللتواصل بين ElasticSearch العُقد

الترخيص

يتطلب كل عملية تثبيت Edge ملف ترخيص فريدًا تحصل عليه من Apigee. وسوف تحتاج إلى توفير المسار إلى ملف الترخيص عند تثبيت خادم الإدارة، على سبيل المثال /tmp/license.txt.

تنسخ أداة التثبيت ملف الترخيص إلى /&lt;inst_root&gt;/apigee/customer/conf/license.txt.

إذا كان ملف الترخيص صالحًا، يتحقّق خادم الإدارة من تاريخ انتهاء الصلاحية ويسمح لتطبيق "الرسائل" عدد المعالجات (MP). في حال انتهاء صلاحية أي من إعدادات الترخيص، يمكنك العثور على السجلّات في الموقع التالي: /&lt;inst_root&gt;/apigee/var/log/edge-management-server/logs. في هذه الحالة، يمكنك التواصل مع فريق دعم Apigee للحصول على تفاصيل النقل.

إذا لم يكن لديك ترخيص حتى الآن، يُرجى التواصل مع فريق المبيعات هنا.