אחרי שהגדרתם את Google Cloud ואת ממשק המשתמש של Apigee, והתקנתם והגדרתם את זמן הריצה, אתם מוכנים לראות איך הכול עובד ביחד.
1. יצירת שרת proxy חדש של API באמצעות ממשק המשתמש של Apigee
בקטע הזה מוסבר איך ליצור שרת proxy חדש ל-API בממשק המשתמש באמצעות האשף ליצירת שרתי proxy ל-API.
כדי ליצור proxy פשוט ל-API באמצעות האשף ליצירת proxy ל-API:
- פותחים את ממשק המשתמש של Apigee בדפדפן.
- בוחרים את הארגון מהתפריט הנפתח בפינה הימנית העליונה.
- בתצוגה הראשית, בוחרים באפשרות פיתוח > שרתי proxy של API.
- לוחצים על Create New (יצירת חדש). מתחיל אשף API Proxy.
- בוחרים באפשרות שרת proxy הפוך (האפשרות הנפוצה ביותר).
מוצגת התצוגה Proxy details.
- מגדירים את ה-proxy עם ההגדרות הבאות:
- שם שרת ה-Proxy: מזינים myproxy. השלבים הבאים בקטע הזה מניחים שמדובר במזהה של ה-proxy.
- נתיב בסיס של שרת 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. ההגדרה הזו מגדירה את כתובת היעד שאליה Apigee שולח בקשה ל-proxy ל-API. שירות mocktarget מתארח ב-Apigee ומחזיר נתונים פשוטים. לא נדרש מפתח API או טוקן גישה.
הפרטים של שרת ה-API שלכם צריכים להיראות כך:
- לוחצים על הבא.
- במסך מדיניות, בוחרים באפשרות העברה (ללא הרשאה) כאפשרות האבטחה.
- לוחצים על הבא.
- במסך סיכום, בוחרים סביבה לפריסת ה-proxy ולוחצים על יצירה ופריסה.
ה-Proxy נוצר על ידי Hybrid (לפעמים הוא נקרא חבילת ה-Proxy):
- לוחצים על מעבר לרשימת שרתי ה-Proxy.
ב-Apigee מוצג התצוגה Proxies, שבה מופיעה רשימה של שרתי proxy של API. שרת ה-proxy החדש אמור להופיע עם אינדיקטור סטטוס ירוק, כלומר הוא נפרס.
2. קריאה ל-proxy ל-API
כשממשק המשתמש מציין שהפרוקסי נפרס, אפשר לנסות להתקשר אליו באמצעות cURL או לקוח REST לבחירתכם. לדוגמה:
- מוודאים שמשתנה הסביבה
DOMAINמוגדר לשם הדומיין שבו השתמשתם עבור שם המארח של קבוצת הסביבות בהגדרת הפרויקט והארגון – שלב 3: יצירת קבוצת סביבות.echo $DOMAIN
-
כדי למצוא את כתובת ה-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
- מייצאים את כתובת ה-IP החיצונית והיציאה למשתנים:
export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER - קוראים ל-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 הראשון.