הגדרת מארח וירטואלי

Edge for Private Cloud גרסה 4.18.05

מארח וירטואלי ב-Edge מגדיר את הדומיינים ואת יציאות Edge Router שבהם שרתי proxy ל-API חשופים, וכתוצאה מכך גם את כתובת ה-URL שבה האפליקציות משתמשות כדי לגשת לשרתי proxy ל-API. מארח וירטואלי מגדיר גם אם הגישה ל-API proxy תתבצע באמצעות פרוטוקול HTTP או באמצעות פרוטוקול HTTPS מוצפן.

כחלק מתהליך ההצטרפות של Edge, צריך ליצור ארגון, סביבה מארח וירטואלי. כדי להקל על המשתמשים החדשים, ב-Edge יש את הפקודה setup-org.

כשיוצרים את המארח הווירטואלי, צריך לציין את הפרטים הבאים:

  • השם של המארח הווירטואלי שבו אתם משתמשים כדי להפנות אליו בשרתי ה-proxy של ה-API.
  • היציאה בנתב של המארח הווירטואלי. בדרך כלל היציאות האלה מתחילים ב-9001 וגדלים בפעם אחת עבור כל מארח וירטואלי חדש.
  • הכינוי של המארח של המארח הווירטואלי. בדרך כלל שם ה-DNS של המארח הווירטואלי.

לדוגמה, בקובץ תצורה שמועבר לפקודה 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 של של בקשה נכנסת לרשימה של כינויי מארח זמינים כחלק מקביעת שרת ה-proxy ל-API מטפל בבקשה. כששולחים בקשה דרך מארח וירטואלי, צריך לציין שם דומיין שתואם לכינוי המארח של מארח וירטואלי, או מציינת את כתובת ה-IP של הנתב הכותרת Host שמכילה את הכינוי של המארח.

לדוגמה, אם יצרתם מארח וירטואלי עם כינוי מארח של myapis.apigee.net ביציאה 9001, בקשת cURL ל-API דרך המארח הווירטואלי הזה יכולה להשתמש באחד מהפורמטים הבאים:

  • אם יש לכם רשומת DNS עבור myapis.apigee.net:
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • אם אין לכם רשומת DNS עבור myapis.apigee.net:
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    בטופס הזה, מציינים את כתובת ה-IP של הנתב ומעבירים את הכינוי המארח הכותרת Host.

אפשרויות כשאין רשומת DNS למארח הווירטואלי

אפשרות אחת כאשר אין לך רשומת DNS היא להגדיר את הכינוי של המארח לכתובת ה-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