الإصدار 4.17.09 من Edge for Private Cloud
يتناول هذا القسم العمليات الإدارية المختلفة، مثل إنشاء وإدارة وإزالة مؤسسات Apigee والبيئات والمضيفين الافتراضيين في تثبيت Apigee Edge for Private Cloud.
للحصول على مقدمة عن المؤسسات والبيئات والمضيفين الافتراضيين، يُرجى الاطّلاع على لمحة عن الكواكب والمناطق والوحدات والمؤسسات والبيئات والمضيفين الافتراضيين.
التحقّق من حالة المستخدمين والمؤسسة والبيئة
يؤدي Management Server دورًا حيويًا في تجميع جميع المكوّنات الأخرى معًا في عملية تثبيت Edge Private Cloud على الجهاز. يمكنك التحقّق من حالة المستخدم والمؤسسة والنشر على خادم الإدارة من خلال إصدار أوامر CURL التالية:
curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users curl -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 عنوان المضيف للطلب الوارد بقائمة الأسماء البديلة للمضيف كجزء من تحديد الخادم الوكيل لواجهة برمجة التطبيقات الذي يعالج الطلب. عند تقديم طلب من خلال مضيف افتراضي، حدِّد اسم نطاق يتطابق مع الاسم المستعار للمضيف الافتراضي أو حدِّد عنوان 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 الخاص بجهاز التوجيه، وتمرير الاسم المستعار للمضيف في عنوان المضيف.
ملاحظة: يضيف الأمر curl ومعظم المتصفحات والعديد من الأدوات المساعدة الأخرى تلقائيًا عنوان المضيف مع النطاق كجزء من الطلب، لذا يمكنك استخدام أمر curl بالصيغة التالية:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
الخيارات عندما لا يكون لديك إدخال في نظام أسماء النطاقات للمضيف الافتراضي
من بين الخيارات المتاحة عندما لا يكون لديك إدخال في نظام أسماء النطاقات هو ضبط الاسم المستعار للمضيف على عنوان IP الخاص بـ الموجّه ومنفذ المضيف الافتراضي، مثل <routerIP>:port. على سبيل المثال:
192.168.1.31:9001
عند تنفيذ أمر curl بالصيغة التالية:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} يُفضَّل هذا الخيار لأنّه يعمل بشكل جيد مع واجهة مستخدم Edge.
إذا كان لديك عدة أجهزة توجيه، أضِف اسمًا بديلاً للمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي.
بدلاً من ذلك، يمكنك ضبط الاسم المستعار للمضيف على قيمة، مثل temp.hostalias.com. بعد ذلك، عليك تمرير عنوان المضيف في كل طلب:
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}