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

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

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

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

כדי ליצור proxy פשוט ל-API באמצעות האשף ליצירת proxy ל-API:

  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. הוא מגדיר את כתובת ה-URL של היעד שאליו Apigee קורא בבקשה ל-proxy ל-API. שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.

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

  7. לוחצים על הבא.
  8. במסך Policies (מדיניות), בוחרים באפשרות Pass through (no authorization) (העברה ללא אישור) כאפשרות האבטחה.
  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 -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 הראשון.