الإصدار 4.17.01 من Edge for Private Cloud
يحدّد المضيف الافتراضي على Edge النطاقات ومنافذ Edge Router التي يتم عرض الخادم الوكيل لواجهة برمجة التطبيقات عليها، وبالتالي عنوان URL الذي تستخدمه التطبيقات للوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات. يحدّد المضيف الافتراضي أيضًا ما إذا كان يتم الوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات باستخدام بروتوكول HTTP أو بروتوكول HTTPS المشفّر.
كجزء من عملية إعداد Edge، عليك إنشاء مؤسسة وبيئة ومضيف افتراضي. توفّر Edge الأمر setup-org لتسهيل هذه العملية على المستخدمين الجدد.
عند إنشاء المضيف الافتراضي، يجب تحديد المعلومات التالية:
- اسم المضيف الافتراضي الذي تستخدمه للإشارة إليه في الخوادم الوكيلة لواجهة برمجة التطبيقات
- المنفذ على جهاز التوجيه للمضيف الافتراضي. عادةً ما تبدأ هذه المنافذ من 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، ثم عليك تمرير عنوان 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}استخدام منفذ محمي في مضيف افتراضي
إذا أردت إنشاء مضيف افتراضي يربط جهاز التوجيه بمنفذ محمي، مثل أرقام المنافذ الأقل من 1024، عليك ضبط جهاز التوجيه ليعمل كمستخدم لديه إذن الوصول إلى تلك المنافذ. By default, the Router runs as the user "apigee" which does not have access to privileged ports.
لتشغيل Router كمستخدم مختلف:
- بصفتك مستخدمًا جذرًا، أنشئ الملف /opt/apigee/etc/edge-router.d/RUN_USER.sh.
- أضِف الإدخال التالي إلى الملف:
RUN_USER=root
إذا كنت لا تريد تشغيل الموجّه كمستخدم جذر، حدِّد مستخدمًا لديه إذن الوصول إلى المنفذ. - احفظ الملف.
- إذا حدّدت مستخدمًا غير الجذر، غيِّر مالك الملف إلى ذلك المستخدم:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh - أعِد تشغيل جهاز التوجيه:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart