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

Edge for Private Cloud الإصدار 4.17.05

يحدّد المضيف الافتراضي على Edge النطاقات ومنافذ جهاز توجيه Edge التي يتعرّض عليها الخادم الوكيل لواجهة برمجة التطبيقات، وبالتالي، عنوان 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 رأس 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://myapis.apigee.net/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'

    في هذا النموذج، يمكنك تحديد عنوان IP البديل لجهاز التوجيه، وتمرير عنوان IP البديل الخاص بالمضيف.

    ملاحظة: يضيف الأمر 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، ثم عليك ضبط العنوان 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

بعد ذلك، يمكنك تقديم الطلب كما لو كان لديك إدخال DNS:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

استخدام منفذ محمي في مضيف افتراضي

إذا أردت إنشاء مضيف افتراضي يربط جهاز التوجيه بمنفذ محمي، مثل أرقام المنفذ أقل من 1000، يجب إعداد جهاز التوجيه ليعمل كمستخدم لديه إمكانية الوصول إلى هذه المنافذ. يعمل جهاز التوجيه بشكل تلقائي بصفته "apigee" للمستخدم الذي لا يمكنه الوصول إلى المنافذ المميّزة.

لتشغيل جهاز التوجيه كمستخدم مختلف:

  1. كجذر، أنشئ الملف /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. أضِف الإدخال التالي إلى الملف:
    RUN_USER=root
    إذا كنت لا تريد تشغيل جهاز التوجيه كجذر، حدِّد مستخدمًا لديه إذن الوصول إلى المنفذ.
  3. احفظ الملف.
  4. إذا حددت مستخدمًا بخلاف الجذر، فغيِّر مالك الملف إلى هذا المستخدم:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. أعِد تشغيل جهاز التوجيه:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل