שלב 10: פריסת proxy ל-API

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

1. יצירת proxy ל-API חדש באמצעות ממשק המשתמש של Apigee

בקטע הזה מוסבר איך ליצור שרת proxy חדש ל-API בממשק המשתמש באמצעות האשף ליצירת שרתי proxy ל-API.

‫Apigee במסוף Cloud

כדי ליצור proxy חדש ל-API באמצעות Apigee במסוף Cloud:

  1. פותחים את ממשק המשתמש של Apigee במסוף Cloud בדפדפן.
  2. בוחרים את הארגון מהתפריט הנפתח בפינה הימנית העליונה.
  3. בתצוגה הראשית, בוחרים באפשרות פיתוח שרת proxy > שרתי proxy של API.
  4. לוחצים על יצירה.מתחיל האשף ליצירת שרת proxy של API.
  5. בוחרים באפשרות שרת proxy הפוך (הנפוצה ביותר).

    מוצגת התצוגה Proxy details.

  6. מגדירים את ה-proxy עם ההגדרות הבאות:
    • שם שרת proxy: מזינים myproxy. השלבים שנותרו בסעיף הזה מניחים שמדובר במזהה של השרת הפרוקסי.
    • נתיב בסיסי: מוגדר אוטומטית ל-/ ואחריו שם ה-proxy, שבמקרה הזה הוא /myproxy. נתיב הבסיס הוא חלק מכתובת ה-URL שמשמשת לשליחת בקשות ל-API. ‫Edge משתמש בכתובת ה-URL כדי להתאים בקשות נכנסות ולנתב אותן אל proxy ה-API המתאים.
    • (אופציונלי) תיאור: מזינים תיאור ל-proxy ל-API החדש, למשל Testing Apigee Hybrid with a simple proxy.
    • יעד (API קיים): מזינים את הכתובת https://mocktarget.apigee.net. ההגדרה הזו מגדירה את כתובת היעד ש-Apigee מפעיל בבקשה ל-proxy ל-API. שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

    הפרטים של ה-API Proxy צריכים להיראות כך:

    פרטי ה-Proxy באשף ליצירת Proxy.

  7. לוחצים על הבא.
  8. במסך מדיניות, בוחרים באפשרות העברה (ללא הרשאה) כאפשרות האבטחה.
  9. לוחצים על הבא.
  10. בקטע Deploy (optional) (פריסה (אופציונלי)), אפשר לבחור סביבה אחת או יותר לפריסת ה-proxy בשדה Deployment environments (סביבות פריסה). אם אתם לא רוצים לפרוס את ה-proxy בשלב הזה, אתם יכולים להשאיר את השדה סביבות פריסה ריק. תמיד אפשר לפרוס את ה-proxy מאוחר יותר.
  11. לוחצים על יצירה. מערכת Apigee יוצרת את ה-proxy (לפעמים נקרא חבילת ה-proxy).

מערכת Apigee מציגה את התצוגה Proxy summary. אם בחרתם לפרוס את ה-proxy, בקטע Deployments מוצג מספר Revision שהוא 1 כשפורסים אותו בפעם הראשונה. בעמודה סטטוס מוצגות הסביבות שבהן ה-proxy נפרס, עם אינדיקטור סטטוס ירוק.

מתחת לכותרת, בקטע Endpoints מוצגים:

  • נקודות קצה של שרת proxy: נתיב הבסיס שהגדרתם לשרת ה-proxy, שבמקרה הזה הוא /myproxy.
  • נקודות קצה של היעד: נתיב הבסיס שהגדרתם ליעד, שבמקרה הזה הוא https://mocktarget.apigee.net.

גרסה קלאסית של Apigee

כדי ליצור proxy חדש ל-API באמצעות Classic Apigee:

  1. פותחים את ממשק המשתמש של Apigee בדפדפן.
  2. בוחרים את הארגון מהתפריט הנפתח בפינה הימנית העליונה.
  3. בתצוגה הראשית, בוחרים באפשרות פיתוח > שרתי proxy של API.
  4. לוחצים על Create New (יצירת חדש). מתחיל אשף API Proxy.
  5. בוחרים באפשרות שרת proxy הפוך (הנפוצה ביותר).

    מוצגת התצוגה Proxy details.

  6. מגדירים את ה-proxy עם ההגדרות הבאות:
    • שם שרת ה-Proxy: מזינים myproxy. השלבים הבאים בקטע הזה מניחים שמדובר במזהה של השרת הפרוקסי.
    • נתיב בסיס של שרת Proxy: מוגדר אוטומטית ל-‎/myproxy. ‫Proxy Base Path הוא חלק מכתובת ה-URL שמשמשת לשליחת בקשות ל-API. ‫Edge משתמש בכתובת ה-URL כדי להתאים בקשות נכנסות ולנתב אותן אל proxy ה-API המתאים.
    • (אופציונלי) תיאור: מזינים תיאור ל-proxy ל-API החדש, למשל Testing Apigee Hybrid with a simple proxy.
    • יעד (API קיים): מזינים את הכתובת https://mocktarget.apigee.net. ההגדרה הזו מגדירה את כתובת היעד ש-Apigee מפעיל בבקשה ל-proxy ל-API. שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

    הפרטים של ה-API Proxy צריכים להיראות כך:

    פרטי ה-Proxy באשף ליצירת Proxy.

  7. לוחצים על הבא.
  8. במסך Policies (מדיניות), בוחרים באפשרות Pass through (no authorization) (העברה ללא אישור) כאפשרות האבטחה.
  9. לוחצים על הבא.
  10. במסך Summary (סיכום), בוחרים סביבה לפריסת ה-proxy ולוחצים על Create and Deploy (יצירה ופריסה).

    ‫Hybrid יוצר את ה-proxy (לפעמים נקרא חבילת ה-proxy):

    תיבת דו-שיח לאישור יצירת שרת proxy.

  11. לוחצים על מעבר לרשימת שרתי proxy.

    ב-Apigee מוצג התצוגה Proxies, שבה מופיעה רשימה של proxy ל-API. הפרוקסי החדש אמור להופיע עם אינדיקטור סטטוס ירוק, כלומר הוא נפרס.

2. קריאה ל-proxy ל-API

כשממשק המשתמש מציין שהפרוקסי נפרס, אפשר לנסות להתקשר אליו באמצעות cURL או לקוח REST לבחירתכם. לדוגמה:

  1. מוודאים שמשתנה הסביבה DOMAIN מוגדר לשם הדומיין שבו השתמשתם עבור שם המארח של קבוצת הסביבות בהגדרת הפרויקט והארגון – שלב 3: יצירת קבוצת סביבות. 
    echo $DOMAIN

  2. כדי למצוא את כתובת ה-IP החיצונית ואת היציאה של שער הכניסה של Apigee, מריצים את הפקודה הבאה:

    kubectl get svc -n apigee -l app=apigee-ingressgateway

    הפלט אמור להיראות כך: 

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. מייצאים את כתובת ה-IP החיצונית והיציאה למשתנים: 
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
  4. קוראים ל-proxy ל-API: 
    curl  -H Host:$DOMAIN --resolve \
  $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
  https://$DOMAIN:$INGRESS_PORT/myproxy -k

    לדוגמה: 

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k

מידע נוסף על יצירה ופריסה של שרתי proxy ל-API זמין במאמר סקירה כללית על יצירת ה-proxy הראשון.