إعداد مضيف افتراضي

Edge for Private Cloud‏ 4.17.09

يحدِّد المضيف الافتراضي على Edge النطاقات ومنافذ Edge Router التي يتم فيها عرض وكيل واجهة برمجة التطبيقات، وبالتالي عنوان URL الذي تستخدمه التطبيقات للوصول إلى وكيل واجهة برمجة التطبيقات. يحدِّد المضيف الافتراضي أيضًا ما إذا كان يتم الوصول إلى خادم وكيل واجهة برمجة التطبيقات باستخدام بروتوكول HTTP أو بروتوكول HTTPS المشفَّر.

كجزء من عملية إعداد Edge، عليك إنشاء مؤسسة وبيئة و مضيف افتراضي. يوفّر Edge الأمر setup-org لتسهيل هذه العملية للمستخدمين الجدد.

عند إنشاء المضيف الظاهري، يجب تحديد المعلومات التالية:

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

على سبيل المثال، في ملف الإعداد الذي تم تمريره إلى الأمر setup-org، يمكنك تحديد هذه المعلومات على النحو التالي:

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myapis.apigee.net

يقارن جهاز توجيه Edge عنوان المضيف للطلب الوارد بقائمة الأسماء المستعارة للمضيفين المتاحة كجزء من تحديد الخادم الوكيل لواجهة برمجة التطبيقات الذي يعالج الطلب. عند تقديم طلب من خلال مضيف افتراضي، حدِّد اسم نطاق يتطابق مع الاسم المعرِّف للمضيف الافتراضي، أو حدِّد عنوان 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 للراوتر وضبط الاسم المعرِّف للمضيف فيHost.
  
  ملاحظة: يلحق الأمر cURL ومعظم المتصفحات والعديد من الأدوات المساعدة الأخرى تلقائيًا عنوان Host بالنطاق كجزء من الطلب، كي تتمكّن فعليًا من استخدام أمر cURL في النموذج:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

الخيارات في حال عدم توفّر إدخال نظام أسماء نطاقات للمضيف الافتراضي

عندما لا يتوفر لديك إدخال لنظام أسماء النطاقات، يمكنك ضبط الاسم المستعار للمضيف على عنوان IP لجهاز التوجيه ومنفذ المضيف الافتراضي، كـ <routerIP>:port. على سبيل المثال:

VHOST_ALIAS=192.168.1.31:9001

ثم تقوم بإجراء أمر curl في النموذج أدناه:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

يُفضَّل هذا الخيار لأنّه يعمل بشكل جيد مع واجهة مستخدم Edge.

إذا كان لديك عدة أجهزة توجيه، أضِف عنوانًا بديلاً للمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي:

# Specify the IP and port of each router as a space-separated list enclosed in quotes:
# VHOST_ALIAS="192.168.1.31:9001 192.168.1.32:9001"

وبدلاً من ذلك، يمكنك ضبط الاسم المستعار للمضيف على قيمة، مثل 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}