הוספה והגדרה של תוסף

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X.
info

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

כשמגדירים תוסף מחבילת תוספים, מציינים ערכים שמתמקדים באינטראקציה של התוסף עם המשאב החיצוני שלו. לדוגמה, כשמגדירים תוסף של Google Cloud Firestore, מציינים באיזה מסד נתונים התוסף ישתמש כשיוצרים, מקבלים ומוחקים מסמכים. לכל תוסף יש קבוצה משלו של מאפייני תצורה שתואמים להיבטים של המשאב שאליו הוא יוצר אינטראקציה. רשימה של התוספים הכלולים מופיעה במאמר סקירה כללית על תוספים.

בדרך כלל, ההגדרות של כל תוסף כוללות את פרטי הכניסה שבהם התוסף אמור להשתמש כדי לבצע אימות מול המשאב בשמכם.

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

במדריך הוספה של תוסף ושימוש בו מוסבר איך מתחילים.

הוספה והגדרה של תוסף

  1. נכנסים ל-Edge, לוחצים על התפריט אדמין ואז על תוספים.

    בדף Extensions (תוספים) שמופיע מוצגים כל התוספים שהוגדרו מחבילות התוספים שזמינות במערכת. אם רוצים להציג תוסף קיים שהוגדר, אפשר לסנן את הרשימה על ידי הקלדה של מונחי סינון בחלק העליון של הדף.

    בשלבים הבאים תוסיפו תוסף משלכם.

  2. בדף Extension, לוחצים על Add Extension.

    בדף Select an extension (בחירת תוסף) שיופיע, התוספים מחולקים לתוספים ש-Google פיתחה ולתוספים שפיתחו חברות אחרות.

  3. בקטע Select an extension (בחירת תוסף), לוחצים על הכרטיסייה הרצויה ומאתרים את התוסף התואם למשאב החיצוני שאליו רוצים לגשת.

    בתיבה של חבילת התוסף, אפשר ללחוץ על 'הצגת פרטים' כדי להציג מידע על הגרסה של התוסף, על המחבר וכו'.

  4. לוחצים על התיבה של חבילת התוספים כדי להתחיל להגדיר תוסף מהחבילה.

  5. בתיבת הדו-שיח Extension Properties, מזינים שם ותיאור של התוסף ולוחצים על Create.

  6. בדף Extension (תוסף) > My-Extension-Name (שם התוסף שלי) של התוסף שאתם יוצרים, מאתרים את סביבת Apigee Edge שעבורה רוצים להגדיר את התוסף.

    צריך לפרוס את התוסף באותה סביבה שבה נמצא שרת ה-proxy של ה-API שישתמש בו.

  7. לוחצים על השורה של הסביבה ברשימה.

  8. בתיבת הדו-שיח Configuration, בוחרים או מזינים ערכים כדי להגדיר את התוסף הזה.

    לכל תוסף יש מאפייני תצורה משלו. לתיאורים של המאפיינים, אפשר להיעזר במסמך העזרה של התוסף. חומר העזר בנושא תוספים מפורט במאמר סקירה כללית על חומר העזר בנושא תוספים.

  9. לוחצים על שמירה.

פריסה של תוסף

  1. בדף Extension‏ > My-Extension-Name של התוסף, לוחצים על Deploy כדי לפרוס את התוסף לשימוש משרתי proxy של API.

אחרי שפורסים תוסף: