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

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

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

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

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

    התצוגה Proxy details נפתחת.

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

    פרטי ה-proxy ל-API אמורים להיראות כך:

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

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

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

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

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

2. שליחת קריאה ל-proxy ל-API

כשהממשק מציין שהשרת proxy נפרס, אפשר לנסות לקרוא לו באמצעות 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 הראשון.