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

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

   

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

    ‫Hybrid יוצר את ה-Proxy (לפעמים נקרא חבילת ה-Proxy):

    

11. לוחצים על מעבר לרשימת שרתי ה-Proxy.

    ב-Apigee מוצג התצוגה Proxies, שבה מופיעה רשימה של proxy ל-API. הפרוקסי החדש אמור להופיע עם אינדיקטור סטטוס ירוק, כלומר הוא נפרס.

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

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

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

   echo $DOMAIN

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