הגדרת מארחים וירטואליים לענן פרטי

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

בהתקנה מקומית, יש לכם שליטה מלאה על מארחים וירטואליים. אפשר ליצור מארחים וירטואליים לכל ארגון, בכל סביבה, אם אתם משתמשים ב-TLS או לא.

במסמך הזה נסביר איך ליצור מארח וירטואלי פשוט. כלומר, כזו שלא תומכים ב-TLS. לדוגמאות נוספות, כולל דוגמאות ליצירת מארחים וירטואליים שתומכים ב-TLS, ראו הגדרת TLS גישה ל-API של הענן הפרטי.

מידע נוסף:

מידע על כינויים של מארחים

כשיוצרים את המארח הווירטואלי, צריך לציין את כינוי המארח של המארח הווירטואלי. בדרך כלל זהו שם ה-DNS של המארח הווירטואלי.

נתב 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.

    curl http://routerIP:9001/proxy-base-path/resource-path

האפשרויות הזמינות אין רשומת DNS עבור המארח הווירטואלי

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

לאחר מכן אפשר לשלוח בקשה כאילו הייתה רשומת DNS:

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

מידע על יציאות של מארחים וירטואליים ב-Edge ל-Private Cloud מגרסה 4.16.01 ואילך

כשיוצרים מארח וירטואלי, צריך לציין את יציאת הנתב שבה משתמש המארח הווירטואלי. עבור לדוגמה, יציאה 9001.

ב-Apigee לענן פרטי מגרסה 4.16.01 ואילך, כברירת מחדל, הנתב פועל משתמש 'apigee' שאין לו גישה ליציאות בעל הרשאות, בדרך כלל יציאות 1024 ומטה. אם המיקום כשרוצים ליצור מארח וירטואלי שמחבר בין הנתב ליציאה מוגנת, צריך להגדיר את הנתב שיפעל כמשתמש עם גישה ליציאות האלה. מידע נוסף זמין במאמר הגדרת מארח וירטואלי.

יצירת מארחים וירטואליים

הקטע הזה מתאר איך ליצור מארחים וירטואליים של Apigee Edge לענן פרטי. שימו לב שכדי ליצור חשבון חדש מארח וירטואלי, עליכם להיות מנהלי מערכת בארגון.

תוכלו ליצור מארחים וירטואליים של Apigee Edge לענן פרטי באמצעות ה-API או ממשק המשתמש של Edge. הנושאים האלה שמתוארים בסעיפים הבאים.

יצירת מארח וירטואלי באמצעות דפדפן

בקטע הזה נסביר איך ליצור מארח וירטואלי באמצעות דפדפן (ממשק משתמש של Edge בלבד).

כדי ליצור מארח וירטואלי חדש בממשק המשתמש של Edge:

  1. מתחברים לממשק המשתמש של ניהול Edge.
  2. בוחרים באפשרות ניהול > מארחים וירטואליים.

  3. בוחרים את הסביבה מהרשימה הנפתחת.

    Edge מציג רשימה של מארחים וירטואליים עבור הסביבה הזו.

  4. כדי ליצור מארח וירטואלי חדש, בוחרים באפשרות + מארח וירטואלי.

    Edge מציג את הטופס יצירת מארח וירטואלי.

    אפשר גם ללחוץ על השם של מארח וירטואלי קיים כדי לערוך אותו.

  5. מגדירים את המארח הווירטואלי החדש. לתשומת ליבך, השדה כתובת אתר בסיסית חייב לכלול את המאפיין הבא: (כלומר, יש להוסיף בתחילת השדה "http:// " או "https:// ".)

    כמו כן, חשוב לזכור:

    • אין הגבלה על מספר המארחים הווירטואליים שאפשר ליצור
    • פרוטוקול TLS הוא אופציונלי ויכול להיות בגרסאות 1.0, 1.1 או 1.2
    • ניתן להגדיר את היציאה של המארח הווירטואלי
  6. לוחצים על הלחצן יצירה כדי לשמור את המארח הווירטואלי החדש.

יצירת מארח וירטואלי באמצעות ה-API

כדי ליצור מארח וירטואלי באמצעות ה-API, צריך ליצור אובייקט XML שמגדיר את מארח וירטואלי. לדוגמה, אובייקט ה-XML הבא מגדיר מארח וירטואלי שמשתמש ב-HTTP פרוטוקול:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:port</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

שימו לב שהמארח הווירטואלי מכיל מאפיין name. אתם משתמשים בערך של מאפיין name כדי להגדיר שרת proxy ל-API לשימוש במארח הווירטואלי.

לאחר מכן תוכל לגשת לשרת ה-proxy ל-API דרך המארח הווירטואלי הזה, על ידי שליחת בקשה כדי:

http://routerIP:port/proxy-base-path/resource-path
https://routerIP:port/proxy-base-path/resource-path

כאשר:

  • http או https: אם המארח הווירטואלי מוגדר לפעול תומכים ב-TLS, צריך להשתמש ב-HTTPS. אם המארח הווירטואלי לא תומך ב-TLS, צריך להשתמש ב-HTTP.
  • routerIP:port הוא כתובת ה-IP ומספר היציאה של המארח הווירטואלי.
  • הערכים proxy-base-path ו-resource-path מוגדרים כשיוצרים את שרת proxy ל-API.

בדרך כלל, לא מפרסמים את ממשקי ה-API ללקוחות עם כתובת IP ומספר יציאה. במקום זאת, מגדירים רשומת DNS לנתב וליציאה. לדוגמה:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

אם מגדירים את רשומת ה-DNS, צריך ליצור כינוי מארח למארח הווירטואלי שתואם לשם הדומיין של רשומת ה-DNS. הכינוי של המארח חייב להתאים למחרוזת הלקוח מעביר בכותרת Host. מהדוגמה שלמעלה, אפשר לציין את כינוי המארח של api.myCompany.com. 

<VirtualHost name="myVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9005</Port>
</VirtualHost>

כדי ליצור מארח וירטואלי שמשתמש בפרוטוקול HTTP:

  1. יוצרים את המארח הווירטואלי באמצעות יוצרים ממשק API של מארח וירטואלי, שבו ms-IP כתובת ה-IP או שם הדומיין של צומת שרת הניהול:
    $ curl -X POST -H "Content-Type:application/xml" \
http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
-d '<VirtualHost name="newVHost">
    <HostAliases>
      <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9005</Port>
  </VirtualHost>' \
-u sysAdminEmail:password
  2. יוצרים את רשומת ה-DNS למארח הווירטואלי שתואם לכינוי של המארח.
  3. אם יש לך שרתי proxy קיימים ל-API, צריך להוסיף את המארח הווירטואלי לרכיב <HTTPConnection> בנקודת הקצה של שרת ה-proxy. המארח הווירטואלי מתווסף באופן אוטומטי לכל שרתי ה-proxy החדשים ל-API. ראו הגדרת שרת proxy ל-API לשימוש במארח וירטואלי.

שינוי מארח וירטואלי

כדי לשנות מארח וירטואלי, מבצעים את הפעולות הבאות:

  1. מעדכנים את המארח הווירטואלי באמצעות עדכון API של מארח וירטואלי, שבו <ms-IP> היא כתובת ה-IP או שם הדומיין של הצומת של שרת הניהול. עליך לציין את ההגדרה המלאה של מארח וירטואלי בגוף הבקשה, לא רק את הרכיבים שרוצים לשנות. כאן לדוגמה, אפשר לשנות את מספר היציאה של המארח הווירטואלי מ-9008 ל-9009:

    curl -X PUT -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
  -d '<VirtualHost name="newVHost">
    <HostAliases>
      <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9009</Port>
  </VirtualHost>' \
  -u email:password
  2. ל-Edge for Private Cloud בגרסאות 4.16.01 ו-4.16.05 בלבד, אם תשנו במארח וירטואלי קיים, ואפשר להפעיל TLS או להשבית TLS בלי לשנות את היציאה. מספר, ואז:

    1. עוצרים את הנתב:

      /opt/apigee/apigee-service/bin/apigee-service edge-router stop

    2. מחיקת הקבצים בתיקייה /opt/nginx/conf.d:

      rm -f /opt/nginx/conf.d/*

    3. מפעילים את הנתב:

      /opt/apigee/apigee-service/bin/apigee-service edge-router start
    4. חוזרים על הפעולה עבור כל הנתבים.