הגדרה ראשונית

לפני שמתקינים ומגדירים את המחבר, צריך להקצות את API Hub וליצור את המשאבים הנדרשים בפרויקט Google Cloud:

הקצאת הרשאות ב-API Hub

  1. יוצרים פרויקט ב-Google Cloud: אם אין לכם פרויקט, אתם יכולים ליצור פרויקט חדש ב-Google Cloud באמצעות המסוף או gCloud CLI. מוודאים שכל ההגדרות שקשורות לחיוב מוגדרות. מידע נוסף זמין במאמר בנושא יצירת פרויקט ב-Google Cloud.
  2. הקצאת API Hub: מפעילים את ממשקי ה-API של API Hub ופועלים לפי תהליך ההקצאה באמצעות ממשק המשתמש של Google Cloud. מפעילים את ההרשאות ואת התוספים שנדרשים לעיבוד מטא-נתונים או אירועים בזמן ריצה.

יצירת פלאגין

בשלב הזה מגדירים חשבון שירות ורושמים את הארגונים שלכם ב-Apigee Edge לענן פרטי ב-API Hub.

  1. יצירת חשבון שירות: יוצרים חשבון שירות חדש ב-Google Cloud בפרויקט של הלקוח. חשבון השירות הזה ישמש את המחבר של Apigee API Hub for Private Cloud כדי לכתוב מטא-נתונים של API ונתוני זמן ריצה ל-API Hub. מידע נוסף מופיע במאמר יצירת חשבונות שירות.

יצירת מופע של פלאגין במרכז ה-API

  1. רישום של ארגונים ב-Apigee Edge for Private Cloud:

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

  2. הגדרת חשבון שירות:

    במהלך יצירת מופע הפלאגין, צריך לספק את חשבון השירות שנוצר בשלב הקודם. חשבון השירות ישמש את המחבר של Apigee API Hub for Private Cloud כדי לכתוב מטא-נתונים של API ונתוני זמן ריצה ל-API Hub.

  3. טופולוגיות אפשריות לכמה ארגונים::
    • אפשרות 1: חשבונות שירות נפרדים לכל ארגון: יוצרים חשבון שירות ייעודי לכל ארגון. כל מופע של תוסף יקושר לחשבון השירות המתאים. במקרה כזה, לחשבון השירות של שירות ההתחזות למפתח צריכות להיות הרשאות ליצירת מפתחות בשם כל חשבון שירות בנפרד.
    • אפשרות 2: חשבון שירות יחיד לכמה ארגונים: אם אתם מעדיפים הגדרה פשוטה יותר, אתם יכולים להשתמש בחשבון שירות אחד לכל הארגונים. השיטה הזו מפשטת את ההגדרה, כי כל הארגונים ישתמשו באותו חשבון שירות. עם זאת, המשמעות של הגישה הזו היא ששינויים בחשבון השירות (כמו החלפת מפתחות) ישפיעו על כל הארגונים שמחוברים אליו.
    • טיפול בכמה מכונות של Apigee Edge for Private Cloud: אם ההגדרה שלכם כוללת כמה מכונות של Apigee Edge for Private Cloud, אותם עקרונות חלים גם כאן. לכל מופע של Apigee Edge for Private Cloud, תצטרכו מופע נפרד של פלאגין לכל ארגון. אפשר לבצע את הפעולות הבאות:
      • להשתמש בחשבונות שירות נפרדים לכל מופע של Apigee Edge for Private Cloud, או
      • אפשר להשתמש בחשבון שירות יחיד לכמה מופעים של Apigee Edge לענן פרטי, בהתאם לטופולוגיה שנבחרה.

אחרי שיוצרים בהצלחה מופע של פלאגין:

אחרי שיוצרים את מופע הפלאגין, מקבלים את פרטי המפתח הבאים שנדרשים להגדרת המחבר של Apigee API Hub לענן פרטי:

  • נושא של pub/sub של נתוני זמן ריצה: נושא של pub/sub להעלאה של נתוני זמן ריצה של API (נתוני ניתוח).
  • נושא pub/sub של מטא-נתונים: נושא pub/sub להעלאת מטא-נתונים של API.
  • מזהה מופע של התוסף: מזהה ייחודי של שער Apigee Edge for Private Cloud, בפורמט: projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID.