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

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

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. הוא מגדיר את כתובת ה-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.

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 הראשון.