الإصدار 4.19.01 من Edge for Private Cloud
يتناول هذا القسم العمليات الإدارية المختلفة، مثل إنشاء وإدارة و إزالة مؤسسات Apigee وبيئاتها وخوادمها الافتراضية في عملية تثبيت Apigee Edge for Private Cloud.
للحصول على مقدّمة عن المؤسسات والبيئات والمضيفين الظاهريين، يُرجى الاطّلاع على لمحة عن الكواكب والمناطق والوحدات والهيئات والبيئات والمضيفين الظاهريين.
التحقّق من حالة المستخدمين والمؤسسة والبيئة
يلعب "خادم الإدارة" دورًا حيويًا في تجميع جميع المكوّنات الأخرى معًا في عملية
تثبيت Edge Private Cloud على الموقع. يمكنك التحقّق من حالة المستخدم والمؤسسة والنشر على خادم الإدارة من خلال إصدار أوامر curl
التالية:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
من المفترض أن يعرض النظام حالة HTTP 200 لجميع الطلبات. إذا لم تنجح هذه الخطوات، اتّبِع الخطوات التالية:
- تحقَّق من سجلّات "خادم الإدارة" على
/opt/apigee/var/log/apigee/management-server
بحثًا عن أي أخطاء. - يمكنك إجراء مكالمة مع "خادم الإدارة" للتحقّق مما إذا كان يعمل بشكل صحيح.
- أزِل الخادم من ELB ثم أعِد تشغيل خادم الإدارة:
/opt/apigee/bin/apigee-service management-server restart
لمحة عن استخدام ملفات الإعداد
تأخذ الأوامر الموضّحة أدناه ملفّ إعدادات كمدخل. على سبيل المثال، يمكنك تمرير ملفّ ضبط إلى الأمر setup-org لتحديد جميع خصائص المؤسّسة، بما في ذلك البيئة والخادم الافتراضي.
للحصول على ملف إعداد كامل ومعلومات عن السمات التي يمكنك ضبطها في ملف الإعداد، يُرجى الاطّلاع على مقالة إعداد مؤسسة.
لمحة عن إعداد مضيف افتراضي
يحدد المضيف الافتراضي على Edge النطاقات ومنافذ Edge Router التي يتم الكشف عليها عن الخادم الوكيل لواجهة برمجة التطبيقات، وبالتالي، عنوان URL الذي تستخدمه التطبيقات للوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات. يحدِّد المضيف الافتراضي أيضًا ما إذا كان يتم الوصول إلى خادم وكيل واجهة برمجة التطبيقات باستخدام بروتوكول HTTP أو بروتوكول HTTPS المشفَّر.
استخدِم النصوص البرمجية وطلبات البيانات من واجهة برمجة التطبيقات الموضَّحة أدناه لإنشاء مضيف افتراضي. عند إنشاء المضيف الافتراضي، يجب تحديد المعلومات التالية:
- اسم المضيف الافتراضي الذي تستخدمه للإشارة إليه في واجهة برمجة التطبيقات الوكيلة
- المنفذ على جهاز التوجيه للمضيف الافتراضي تبدأ هذه المنافذ عادةً من الرقم 9001 وتزداد بمقدار واحد لكل مضيف افتراضي جديد.
- العنوان البديل للمضيف للجهاز المضيف الافتراضي. عادةً ما يكون اسم نظام أسماء النطاقات للمضيف
الافتراضي.
يقارن جهاز Edge Router رأس Host للطلب الوافد بقائمة الأسماء البديلة للمضيفين كجزء من تحديد خادم وكيل واجهة برمجة التطبيقات الذي يعالج الطلب. عند تقديم طلب من خلال مضيف افتراضي، يمكنك إما تحديد اسم نطاق يتطابق مع الاسم المستعار للمضيف لمضيف افتراضي، أو تحديد عنوان IP لجهاز التوجيه وعنوان المضيف الذي يحتوي على الاسم المستعار للمضيف.
على سبيل المثال، إذا أنشأت مضيفًا افتراضيًا باستخدام عنوان بديل للمضيف هو
myapis.apigee.net على المنفذ 9001، ثم نفَّذ طلبًا
curl
إلى واجهة برمجة تطبيقات من خلال هذا المضيف الافتراضي، يمكن أن يستخدم أحد الأشكال التالية:
- إذا كان لديك إدخال نظام أسماء النطاقات myapis.apigee.net:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- إذا لم يكن لديك إدخال في نظام أسماء النطاقات لـ myapis.apigee.net:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
وفي النموذج الثاني، عليك تحديد عنوان IP لجهاز التوجيه، وتمرير اسم المضيف المستعار في عنوان المضيف.
الخيارات في حال عدم توفّر إدخال نظام أسماء نطاقات للمضيف الافتراضي
أحد الخيارات المتاحة لك في حال عدم توفّر إدخال في نظام أسماء النطاقات هو ضبط الاسم المعرِّف للمضيف على عنوان IP لجهاز الصعِيد والمنفذ للمضيف الافتراضي، كما هو موضّح في routerIP:port. على سبيل المثال:
192.168.1.31:9001
بعد ذلك، يمكنك إنشاء أمر curl
بالشكل أدناه:
curl http://routerIP:9001/proxy-base-path/resource-path
هذا الخيار مُفضل لأنه يعمل بشكل جيد مع واجهة مستخدم Edge.
إذا كان لديك عدة أجهزة توجيه، أضِف عنوانًا بديلاً للمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي.
بدلاً من ذلك، يمكنك ضبط الاسم المعرِّف للمضيف على قيمة، مثل temp.hostalias.com.
بعد ذلك، عليك تمرير العنوان Host
في كل طلب:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'
أو أضِف الاسم المعرِّف للمضيف إلى ملف /etc/hosts
. مثلاً، أضِف هذا السطر إلى /etc/hosts
:
192.168.1.31 temp.hostalias.com
يمكنك بعد ذلك تقديم طلب كما لو كان لديك إدخال في نظام أسماء النطاقات:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path