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

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

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

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

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

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

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

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

    פרטי ה-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.

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

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

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

  2. כדי למצוא את כתובת ה-IP החיצונית ואת היציאה של שער הכניסה (ingress) של 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 הראשון.