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

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

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

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

‫Apigee ב-Cloud Console

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

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

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

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

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

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

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

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

מתחת לזה, בקטע Revisions (גרסאות) מוצגות כל הגרסאות של ה-proxy הזה. אם לוחצים על אחד מהפריטים בעמודה תצוגה בטבלה סיכום נקודות הקצה, מוצג הקטע נקודת קצה עם הפרטים הבאים:

  • נקודות קצה של שרת 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. מערכת Apigee משתמשת בכתובת ה-URL כדי להתאים בקשות נכנסות ולנתב אותן ל-proxy ל-API המתאים.
    • (אופציונלי) תיאור: מזינים תיאור ל-proxy ל-API החדש, למשל Testing Apigee Hybrid with a simple proxy.
    • יעד (API קיים): מזינים את הכתובת https://mocktarget.apigee.net. הוא מגדיר את כתובת ה-URL של היעד שאליו Apigee קורא בבקשה ל-proxy ל-API. שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

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

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

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

    ה-Hybrid יוצר את ה-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_NAMESPACE -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 -v

    לדוגמה: 

    curl -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v
  5. קריאה מוצלחת ל-Proxy מחזירה קוד תגובה מסוג HTTP 200 ואת הפלט הבא.

    Hello, Guest!

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