אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
Apigee Edge כולל כמה חבילות של תוספים שהותקנו. כדי להשתמש בתוסף ב-proxy ל-API עם מדיניות Extension Callout, צריך להוסיף ולהגדיר את התוסף. כשמוסיפים תוסף, מאתרים את חבילת התוסף שמייצגת את המשאב החיצוני שרוצים לשלב עם proxy ל-API, מוסיפים ומגדירים תוסף מהחבילה הזו ומפריסים את התוסף בסביבת Edge.
כשמגדירים תוסף מחבילת תוספים, מציינים ערכים שממקד את האינטראקציה של התוסף עם המשאב החיצוני שלו. לדוגמה, כשמגדירים תוסף של Google Cloud Firestore, מציינים באיזה מסד נתונים התוסף צריך להשתמש כשיוצרים, מקבלים ומוחקים מסמכים. לכל תוסף יש קבוצה משלו של מאפייני הגדרה שתואמים להיבטים של המשאב שאיתו הוא מבצע אינטראקציה. רשימה של התוספים הכלולים זמינה במאמר סקירה כללית של חומר עזר בנושא תוספים.
בדרך כלל, ההגדרה של כל תוסף כוללת את פרטי הכניסה שהתוסף צריך להשתמש בהם כדי לבצע אימות מול המשאב בשמכם.
סביבת הפריסה של התוספים היא גמישה כדי לתמוך בהתאמת קנה מידה אוטומטית על סמך העומס. לכן, כברירת מחדל, יכול להיות שפריסת תוסף ללא תנועה לא תכלול מופע זמין שיגיב לבקשות. לכן, יכול להיות שהבקשה הראשונה לתוסף תיקח יותר זמן, בזמן שהסביבה יוצרת מופע של התוסף לשימוש.
כדי להתחיל, אפשר לעיין במדריך מדריך: הוספה ושימוש בתוסף.
הוספה והגדרה של תוסף
נכנסים ל-Edge, לוחצים על תפריט הניהול ואז על תוספים.
בדף Extensions שמופיע מוצגים כל התוספים שהוגדרו מחבילות תוספים שזמינות במערכת. כדי לראות תוסף קיים שהוגדר, אפשר לסנן את הרשימה על ידי הקלדת מונחי סינון בחלק העליון של הדף.
בשלבים הבאים נסביר איך להוסיף תוסף משלכם.
בדף Extension (תוסף), לוחצים על Add Extension (הוספת תוסף).
בדף 'בחירת תוסף' שמופיע, התוספים מחולקים לתוספים שפותחו על ידי Google ולתוספים שפותחו על ידי חברות אחרות.
בקטע בחירת תוסף, לוחצים על הכרטיסייה הרצויה ומאתרים את התוסף שמתאים למשאב החיצוני שאליו ניגשים.
בתיבה של חבילת התוסף, אפשר ללחוץ על 'הצגת פרטים' כדי לראות מידע על גרסת התוסף, המחבר וכו'.
לוחצים על התיבה של חבילת התוסף כדי להתחיל להגדיר תוסף מהחבילה.
בתיבת הדו-שיח Extension Properties (מאפייני התוסף), מזינים שם ותיאור לתוסף ולוחצים על Create (יצירה).
בדף Extension > My-Extension-Name של התוסף שאתם יוצרים, מאתרים סביבת Apigee Edge שרוצים להגדיר בשבילה את התוסף.
צריך לפרוס תוסף באותה סביבה שבה נמצא proxy ל-API שישתמש בו.
לוחצים על השורה של הסביבה ברשימה.
בתיבת הדו-שיח הגדרה, בוחרים או מזינים ערכים כדי להגדיר את התוסף הזה.
לכל תוסף יש מאפייני הגדרה משלו. כדי לקבל תיאורים של המאפיינים, אפשר להשתמש בהפניה של התוסף. הפניות לתוספים מפורטות בסקירה כללית של הפניות לתוספים.
לוחצים על שמירה.
פריסת תוסף
- בדף Extension > My-Extension-Name של התוסף, לוחצים על Deploy כדי לפרוס את התוסף לשימוש מתוך proxy ל-API.
אחרי שמפעילים תוסף:
מוסיפים את התוסף ל-proxy ל-API באמצעות מדיניות Extension Callout.
אפשר לראות את נתוני היומן שנוצרו על ידי התוסף. מידע נוסף זמין במאמר בנושא צפייה ביומני תוספים.