الإصدار 4.18.01 من Edge for Private Cloud
متطلبات الأجهزة
يجب أن تستوفي الحد الأدنى من متطلبات الأجهزة التالية للحصول على البنية التحتية في بيئة مستوى الإنتاج. لجميع سيناريوهات التثبيت الموضحة في طوعيات التثبيت، تسرد الجداول التالية الحد الأدنى من متطلبات الأجهزة لمكونات التثبيت.
في هذه الجداول، تكون متطلبات القرص الثابت بالإضافة إلى مساحة القرص الثابت التي يتطلبها نظام التشغيل. واستنادًا إلى التطبيقات وحركة بيانات الشبكة، قد تحدث عملية التثبيت تتطلب موارد أكثر أو أقل مما هو مذكور أدناه.
مكوِّن التثبيت | ذاكرة الوصول العشوائي (RAM) | وحدة معالجة مركزية (CPU) | الحد الأدنى للقرص الثابت |
---|---|---|---|
كاساندرا | 16 غيغابايت | ثماني النواة | مساحة تخزين محلية تبلغ 250 غيغابايت مع محرك أقراص ذي حالة صلبة (SSD) أو قرص صلب (HDD) سريع يتوافق مع 2000 عملية IOPS |
معالج/جهاز توجيه الرسائل على نفس الجهاز | 16 غيغابايت | ثماني النواة | 100 غيغابايت |
Analytics: Postgres/Qpid على الخادم نفسه (لا يُنصَح بهذا الإجراء لمرحلة الإنتاج) | 16 غيغابايت* | ثماني النواة* | مساحة تخزين على الشبكة بسعة 500 غيغابايت - 1 تيرابايت*****، ويُفضَّل أن يتم استخدامها مع الواجهة الخلفية لمحرك الأقراص ذي الحالة الصلبة، يتيح 1,000 عملية IOPS أو أكثر* |
إحصاءات - Postgres مستقل | 16 غيغابايت* | ثماني النواة* | مساحة تخزين على الشبكة بسعة 500 غيغابايت - 1 تيرابايت*****، ويُفضَّل أن يتم استخدامها مع الواجهة الخلفية لمحرك الأقراص ذي الحالة الصلبة، يتيح 1,000 عملية IOPS أو أكثر* |
"إحصاءات Google" - Qpid مستقل | 8 غيغابايت | رباعي النواة | مساحة تخزين محلية تتراوح بين 30 و50 غيغابايت مع محرك أقراص ذي حالة صلبة أو محرك أقراص ثابتة سريع
بالنسبة إلى عمليات التثبيت التي تزيد عن 250 وحدة في الثانية، يتم استخدام محرك الأقراص الثابتة مع مساحة تخزين محلية تتيح 1000 عملية IOPS الموصى بها. حجم قائمة انتظار Qpid التلقائي هو 20 غيغابايت. إذا كنت بحاجة إلى إضافة سعة أكبر، يمكنك إضافة المزيد عُقد Qpid. |
غير ذلك (OpenLDAP وواجهة المستخدم وخادم الإدارة) | 4 غيغابايت | ثنائي النواة | 60 غيغابايت |
* ضبط متطلبات نظام Postgres استنادًا إلى سرعة معالجة البيانات:
- أقل من 250 وحدة TPS: يمكن استخدام شبكة مُدارة بسعة 8 غيغابايت مع اتصال رباعي النواة مساحة تخزين*** تتيح 1000 عملية IOPS أو أكثر
- أكثر من 250 التيار في الثانية: وحدة تخزين شبكة مُدارة بسعة 16 غيغابايت، ثماني النواة*** يتيح 1000 عملية IOPS أو أكثر
- أكثر من 1,000 وحدة TPS: مساحة تخزين شبكة مُدارة بسعة 16 غيغابايت، ثماني النواة*** تدعم 2000 عملية IOPS أو أعلى
- أكثر من 2000 وحدة TPS: مساحة تخزين شبكة مُدارة بسعة 32 غيغابايت، بنظام 16 نواة*** تدعم 2000 عملية IOPS أو أعلى
- أكثر من 4,000 وحدة TPS: ذاكرة تخزين شبكة مُدارة بسعة 64 غيغابايت، بنظام 32 نواة*** يتيح 4000 عملية IOPS أو أكثر
** تستند قيمة القرص الثابت في Postgres إلى الإحصاءات غير الجاهزة التي تم الحصول عليها من خلال Edge. إذا أضفت قيمًا مخصّصة إلى بيانات الإحصاءات، من المفترض زيادة هذه القيم. وفقًا لذلك. استخدِم الصيغة التالية لتقدير مساحة التخزين المطلوبة:
bytes of storage needed =
(# bytes of analytics data/request) *
(requests/second) *
(seconds/hour) *
(hours of peak usage/day) *
(days/month) *
(months of data retention)
على سبيل المثال:
(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)
= 1,194,393,600,000 bytes or 1194.4 GB
*** يُنصَح بتفعيل تخزين الشبكة لقاعدة بيانات Postgresql للأسباب التالية:
- تتيح لكم أيضًا زيادة حجم مساحة التخزين بشكل ديناميكي في حال حدوث ذلك. مطلوبة.
- يمكن ضبط عمليات IOPS للشبكة بشكل سريع في معظم أوقات للبيئة/التخزين/الشبكة الفرعية.
- يمكن تفعيل لقطات مستوى التخزين كجزء من الاحتفاظ بنسخة احتياطية والاسترداد الرائدة.
بالإضافة إلى ذلك، تسرد القائمة التالية متطلبات الأجهزة إذا كنت تريد تثبيت خدمات تحقيق الربح:
المكوِّن مع تحقيق الربح | ذاكرة الوصول العشوائي (RAM) | وحدة معالجة مركزية (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 غيغابايت |
كاساندرا** | 16 غيغابايت | ثماني النواة | مساحة تخزين محلية تبلغ 250 غيغابايت مع محرك أقراص ذي حالة صلبة (SSD) أو قرص صلب (HDD) سريع يتوافق مع 2000 عملية IOPS |
* يمكنك تثبيت ElasticSearch وBaaS Stack على نفس العقدة. إذا فعلت ذلك، تهيئة ElasticSearch لاستخدام ذاكرة سعتها 4 غيغابايت (افتراضي). إذا كان تطبيق ElasticSearch مثبتًا العقدة الخاصة بها، ثم إعدادها لاستخدام ذاكرة بسعة 6 جيجا بايت.
** اختياري؛ عادةً ما تستخدم مجموعة Cassandra نفسها لكل من Edge وBaaS لواجهة برمجة التطبيقات الخدمات.
نظام التشغيل والجهة الخارجية متطلبات البرامج
تم اختبار إرشادات التثبيت هذه وملفات التثبيت المُقدَّمة على أنظمة التشغيل والبرامج الخارجية المدرجة في البرامج المتوافقة والإصدارات المتوافقة
إنشاء مستخدم apigee
يؤدي إجراء التثبيت إلى إنشاء مستخدم نظام Unix باسم "apigee". أدلة Edge الملفات مملوكة من قِبل "apigee"، كما هي الحال مع عمليات Edge. هذا يعني أن مكونات Edge تعمل "apigee" المستخدم. إذا لزم الأمر، يمكنك تشغيل المكونات كمستخدم مختلف.
دليل التثبيت
بشكل تلقائي، يكتب المثبت جميع الملفات في الدليل /opt/apigee
. إِنْتَ
لا يمكن تغيير موقع الدليل هذا. بينما لا يمكنك تغيير هذا الدليل، يمكنك إنشاء
رمزي لربط "/opt/apigee
" بموقع آخر، كما هو موضَّح أدناه.
في التعليمات الواردة في هذا الدليل، تتم الإشارة إلى دليل التثبيت
/opt/apigee
إنشاء رابط رمزي من /opt/apigee
قبل إنشاء الرابط الرمزي، يجب أولاً إنشاء مستخدم ومجموعة باسم "apigee". هذا هو نفس المجموعة والمستخدم الذي تم إنشاؤه بواسطة أداة تثبيت Edge.
لإنشاء الرابط الرمزي، نفذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.18.01.sh. يجب تنفيذ كل هذه الخطوات كجذر:
- إنشاء "واجهة برمجة تطبيقات" المستخدم والمجموعة:
groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
- أنشِئ رابطًا رمزيًا من
/opt/apigee
إلى جذر التثبيت المطلوب:ln -Ts /srv/myInstallDir /opt/apigee
حيث /srv/myInstallDir هو الموقع المطلوب لملفات Edge.
- تغيير ملكية جذر التثبيت والرابط الرمزي إلى "apigee" المستخدم:
chown -h apigee:apigee /srv/myInstallDir /opt/apigee
Java
عليك تثبيت إصدار متوافق من Java 1.8 على كل جهاز قبل عملية التثبيت. يتم إدراج ملفات JDK المتوافقة في البرامج المتوافقة والإصدارات المتوافقة
تأكَّد من أنّ JAVA_HOME
يشير إلى جذر JDK للمستخدم الذي يُجري عملية
التثبيت.
SELinux
بناءً على إعدادات SELinux، يمكن أن تواجه Edge مشكلات في التثبيت والبدء مكونات الحافة. إذا لزم الأمر، يمكنك تعطيل SELinux أو تعيينه على الوضع المتساهِل أثناء ثم إعادة تمكينه بعد التثبيت. راجع تثبيت أداة إعداد واجهة برمجة التطبيقات Edge لمعرفة المزيد.
إعدادات الشبكة
ننصحك بمراجعة إعدادات الشبكة قبل التثبيت. أداة التثبيت أن جميع الأجهزة تحتوي على عناوين IP ثابتة. استخدم الأوامر التالية للتحقق من صحة الإعداد:
- تعرض الدالة
hostname
اسم الجهاز. - تعرض
hostname -i
عنوان IP لاسم المضيف الذي يمكن معالجته من أجهزة أخرى.
استنادًا إلى نوع نظام التشغيل وإصداره، قد تحتاج إلى تعديل
/etc/hosts
و/etc/sysconfig/network
إذا لم يكن اسم المضيف
بشكل صحيح. للحصول على مزيد من المعلومات، يمكنك مراجعة وثائق نظام التشغيل المحدد.
فإذا كان الخادم يحتوي على عدة بطاقات واجهة، فإن "اسم المضيف -i" ينتج عنها أمر مفصول بمسافة قائمة بعناوين IP. بشكل تلقائي، تستخدم أداة تثبيت Edge أول عنوان IP تم عرضه، وهو قد لا يكون صحيحًا في جميع المواقف. كخيار بديل، يمكنك ضبط السمة التالية في ملف تهيئة التثبيت:
ENABLE_DYNAMIC_HOSTIP=y
عند ضبط هذه الخاصية على "y"، تطلب منك أداة التثبيت اختيار عنوان IP لاستخدامه في عملية التثبيت. القيمة التلقائية هي "n". عرض مرجع ملف تهيئة الحافة للحصول على مزيد من المعلومات.
أغلفة 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.
بشكل صحيح من خلال فحص /opt/apigee/apigee-cassandra/conf/cassandra.yaml
الملف. على سبيل المثال، تأكَّد من أنّ النص البرمجي للتثبيت Edge for Private Cloud يضبط ما يلي
المواقع:
cluster_name
initial_token
partitioner
seeds
listen_address
rpc_address
snitch
قاعدة بيانات 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
لضبط هذه القيم:
- تعديل ملف postgresql.properties:
vi /opt/apigee/customer/application/postgresql.properties
إذا لم يكن الملف متوفّرًا، أنشئه.
- اضبط الخصائص المدرَجة أعلاه.
- احفظ تعديلاتك.
- أعِد تشغيل قاعدة بيانات PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
حدود النظام
تأكد من تعيين حدود النظام التالية على Cassandra ومعالج الرسائل العُقد:
- في عقد Cassandra، عيّن حدودًا ثابتة وصعبة لفتح القفل، ومساحة العنوان (as) لـ
مستخدم التثبيت (الإعداد التلقائي هو "apigee") في
/etc/security/limits.d/90-apigee-edge-limits.conf
كما هو موضح أدناه:apigee soft memlock unlimited apigee hard memlock unlimited apigee soft nofile 32768 apigee hard nofile 65536 apigee soft as unlimited apigee hard as unlimited
- في عُقد معالج الرسائل، اضبط الحد الأقصى لعدد أدوات وصف الملفات المفتوحة على 64 كيلوبايت
في
/etc/security/limits.d/90-apigee-edge-limits.conf
باسم كما هو موضح أدناه:apigee soft nofile 32768 apigee hard nofile 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:
- في كل عقدة معالج الرسائل، عدِّل
/etc/nscd.conf
- اضبط السمة التالية:
enable-cache hosts no
إيقاف IPv6 على Google Cloud منصة RedHat/CentOS 7
في حال تثبيت Edge على RedHat 7 أو CentOS 7 على Google Cloud Platform، يجب يجب إيقاف IPv6 على جميع عُقد Qpid.
للحصول على تعليمات حول إصدار نظام التشغيل المستخدَم على جهازك، يمكنك الاطّلاع على وثائق RedHat أو CentOS وتعطيل IPv6. يمكنك مثلاً:
- افتح "
/etc/hosts
" في محرِّر. - إدراج "#" حرف في العمود الأول من السطر التالي للتعليق عليه:
#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
- احفظ الملف.
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 |
تجربة |
libxslt |
دورة في الدقيقة |
فك الضغط |
الاسم الأساسي |
Grep |
lua-socket |
rpm2cpio |
إضافة مستخدم |
تحطيم |
اسم المضيف |
الأمر ls الدليل |
درهم إماراتي |
wc |
bc |
id |
أدوات الشبكة |
sudo |
wget |
curl |
ليبايو |
Perl (من Procps) |
القطران |
xerces-c |
سايروس ساسل | libdb4 | pgrep (من Procps) | tr | لذيذ |
التاريخ |
libdb-cxx |
ps |
رقم uuid |
chkconfig |
اسم dirname | أفعال ليبيب | pwd | uname | |
echo | librdmacm | python |
ntpdate
يوصى بتخزين بيانات مرة واحدة. إذا لم يتم إعداده بالفعل،
يمكن لأداة "ntpdate
" استخدام هذا الغرض، والتي تتحقق من
ما إذا كانت الخوادم متزامنة للوقت. يمكنك استخدام yum install ntp
لتثبيت
الأخرى. ويعد هذا مفيدًا بشكل خاص لتكرار إعدادات OpenLDAP. لاحظ أنه يتم إعداد الخادم
المنطقة الزمنية بالتوقيت العالمي المنسق (UTC).
الإصدار 2.4 من بروتوكول Openldap
يتطلب التثبيت داخل المؤسسة الإصدار OpenLDAP 2.4. في حال حذف
أن خادمك متصل بالإنترنت، عندئذٍ يتم تنزيل وتثبيت Edge البرمجي على خادمك
OpenLDAP. إذا لم يكن خادمك متصلاً بالإنترنت، ينبغي لك التأكد من أن OpenLDAP
"مثبت" بالفعل قبل تشغيل النص البرمجي لتثبيت Edge. على RHEL/CentOS، يمكنك تشغيل
yum install openldap-clients openldap-servers
لتثبيت OpenLDAP.
بالنسبة إلى عمليات التثبيت التي تتضمّن 13 مضيفًا وعمليات التثبيت التي تتضمّن 12 مضيفًا مع مركزَي بيانات، يجب توفير ما يلي: النسخ المتماثل لـ OpenLDAP نظرًا لوجود عُقد متعددة تستضيف OpenLDAP.
جدران الحماية والمضيفات الافتراضية
عادةً ما يتم تحميل مصطلح virtual
بشكل زائد في مجال تقنية المعلومات، وبالتالي فهو
نشر Apigee Edge for Private Cloud والمضيفين الافتراضيين للتوضيح، هناك نوعان أساسيان
استخدامات للمصطلح virtual
:
- الأجهزة الافتراضية (VM): غير مطلوب، ولكن تستخدم بعض عمليات النشر تكنولوجيا الأجهزة الافتراضية. لإنشاء خوادم معزولة لمكونات Apigee. يمكن لمضيفي الأجهزة الافتراضية، مثل المضيفين المادي، وواجهات الشبكات والجدران النارية.
- المضيفات الافتراضية: نقاط نهاية الويب، مماثلة لمضيف Apache الافتراضي.
يمكن أن يكشف الموجه في جهاز افتراضي عن مضيفين افتراضيين متعددين (طالما يختلفون عن بعضهم البعض في الاسم المستعار لمضيفه أو في منفذ الواجهة).
وكمثال على التسمية، قد يُشغِّل خادم مادي واحد A
جهازَين افتراضيَين،
باسم "VM1" و"VM2". لنفترض أن "VM1" تعرض واجهة إيثرنت افتراضية، تتم تسميتها
"eth0" داخل الجهاز الافتراضي، والذي يتم تخصيص عنوان IP له 111.111.111.111
من خلال
آلات المحاكاة الافتراضية أو خادم بروتوكول التهيئة الآلية للمضيفين (DHCP) للشبكة؛ ثم نفترض أن VM2 تكشف عن
واجهة إيثرنت تُسمّى أيضًا "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
على الجهاز الافتراضي (VM2) هذه الدالة هي
الخاصة بتثبيتك، وتهيئها مجموعة الشبكات المحلية.
ويتم ضبط المسار الأساسي عند نشر واجهة برمجة تطبيقات. من المثال أعلاه، يمكنك نشر اثنين من واجهات برمجة التطبيقات،
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 إليه. |
يعرض الجدول التالي المنافذ نفسها، مدرَجة رقميًا مع المصدر والوجهة. المكونات:
رقم المنفذ | الغرض | مكوِّن المصدر | مكوِّن الوجهة |
---|---|---|---|
virtual_host_port | HTTP بالإضافة إلى أي منافذ أخرى تستخدمها لعدد زيارات طلبات البيانات من واجهة برمجة التطبيقات للمضيف الظاهري. المنفذان 80 و443 الأكثر استخدامًا؛ بإمكان جهاز توجيه الرسائل إنهاء اتصالات بروتوكول أمان طبقة النقل/طبقة المقابس الآمنة. | العميل الخارجي (أو موازن التحميل) | أداة استماع على جهاز توجيه الرسائل |
1099 إلى 1103 | إدارة JMX | برنامج JMX | خادم الإدارة (1099) معالج الرسائل (1101) خادم Qpid (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 |
7000 | اتصالات بين العُقد من "كاساندرا" | كاساندرا | عقدة كاساندرا أخرى |
7199 | إدارة JMX. يجب أن تكون مفتوحة للوصول على عقدة Cassandra من خلال "الإدارة". الخادم. | عميل JMX | كاساندرا |
8080 | منفذ Management API | برامج Management API | خادم الإدارة |
من 8081 إلى 8084 |
منافذ مكونات واجهة برمجة التطبيقات، يتم استخدامها لإصدار طلبات واجهة برمجة التطبيقات مباشرة إلى المكونات الفردية. يفتح كل مكون منفذًا مختلفًا؛ يعتمد المنفذ الدقيق المستخدم على الإعدادات ولكن يجب فتحها على المكوِّن حتى يمكن الوصول إليه من خلال خادم الإدارة |
برامج Management API | جهاز التوجيه (8081) معالج الرسائل (8082) خادم Qpid (8083) Postgres Server (8084) |
8998 | الاتصال بين جهاز التوجيه ومعالج الرسائل | جهاز التوجيه | معالج الرسائل |
9000 | منفذ واجهة المستخدم التلقائي لإدارة Edge | المتصفح | خادم واجهة مستخدم الإدارة |
9042 | النقل الأصلي لـ CQL | جهاز التوجيه معالج الرسائل خادم الإدارة |
كاساندرا |
9160 | عميل التوفير "كاساندرا" | جهاز التوجيه معالج الرسائل خادم الإدارة |
كاساندرا |
10389 | منفذ LDAP | خادم الإدارة | OpenLDAP |
15999 | منفذ فحص الحالة الصحية يستخدم جهاز موازنة الحمل هذا المنفذ لتحديد ما إذا كان جهاز التوجيه المتوفرة. | جهاز موازنة الحمل | جهاز التوجيه |
59001 | المنفذ الذي تستخدمه الأداة المساعدة "apigee-validate " لاختبار تثبيت Edge |
apigee-validate | جهاز التوجيه |
59002 | منفذ جهاز التوجيه الذي يتم من خلاله إرسال طلبات صفحة Smart Docs | SmartDocs | جهاز التوجيه |
يعمل معالج الرسائل على إبقاء مجموعة اتصال مخصصة مفتوحة لـ "كاساندرا"، والتي يتم ضبطها على عدم انتهاء المهلة أبدًا. عندما يكون جدار حماية بين معالج الرسائل وخادم Cassandra، أن يؤدي جدار الحماية إلى إنهاء الاتصال. ومع ذلك، فإن معالج الرسائل غير مصمم إعادة إنشاء اتصالات مع "كاساندرا".
لمنع هذا الموقف، تنصح Apigee بأن يتم ضبط خادم Cassandra ومعالج الرسائل والموجهات في الشبكة الفرعية نفسها بحيث لا يشارك جدار حماية في نشر هذه والمكونات.
إذا كان جدار الحماية يقع بين جهاز التوجيه ومعالِجات الرسائل، وتم ضبط مهلة Tcp على عدم نشاطه، توصياتنا هي:
- يمكنك ضبط
net.ipv4.tcp_keepalive_time = 1800
في إعدادات sysctl على نظام التشغيل Linux، حيث يجب أن يكون الرقم 1800 أقل من مهلة tcp غير النشطة لجدار الحماية. ينبغي أن يبقي هذا الإعداد اتصال في حالة قائمة، بحيث لا يقطع جدار الحماية الاتصال. - تعديل جميع معالِجات الرسائل
/opt/apigee/customer/application/message-processor.properties
لإضافة الخاصية التالية. إذا لم يكن الملف متوفّرًا، أنشئه.conf_system_cassandra.maxconnecttimeinmillis=-1
- إعادة تشغيل معالج الرسائل:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- تعديل
/opt/apigee/customer/application/router.properties
على جميع أجهزة التوجيه لإضافة الخاصية التالية. إذا لم يكن الملف متوفّرًا، أنشئه.conf_system_cassandra.maxconnecttimeinmillis=-1
- أعِد تشغيل جهاز التوجيه:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
في حال تثبيت التهيئة المجمّعة حسب 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.
تنسخ أداة التثبيت ملف الترخيص إليه
/opt/apigee/customer/conf/license.txt
إذا كان ملف الترخيص صالحًا، يتحقّق خادم الإدارة من تاريخ انتهاء الصلاحية ويسمح لتطبيق "الرسائل"
عدد المعالجات (MP). في حال انتهاء صلاحية أي من إعدادات الترخيص، يمكنك العثور على السجلّات في
الموقع التالي: /opt/apigee/var/log/edge-management-server/logs
.
في هذه الحالة، يمكنك التواصل مع فريق دعم Apigee Edge للحصول على تفاصيل نقل البيانات.
إذا لم يكن لديك ترخيص بعد، يُرجى التواصل مع Apigee Sales.