במסמך הזה מפורטות הוראות להגדרה ולקביעת ההגדרות של מחבר Apigee API Hub לענן פרטי ול-API Hub. המחבר מאפשר להעביר מטא-נתונים של API וניתוח בזמן ריצה מההתקנה של Apigee Edge לענן פרטי אל API Hub של Google Cloud.
השילוב של Apigee Edge for Private Cloud ו-API Hub נועד לגשר בין סביבות Apigee המקומיות לבין API Hub של Google Cloud. השילוב הזה מאפשר זרימה חלקה של מטא-נתונים קריטיים של API (כמו הגדרות של שרתי proxy של API, מדיניות וכו') ונתוני ניתוח בזמן ריצה מההתקנות של Apigee for Private Cloud ישירות אל API Hub, וכך מספק תצוגה מרכזית ומקיפה של סביבת ה-API.
סקירה כללית
השילוב הזה מאפשר למשתמשי Apigee for Private Cloud להוסיף את פרטי ה-API שלהם ל-API Hub. כלומר, אתם יכולים להשתמש ביכולות של API Hub כדי לגלות ממשקי API שמקורם בפריסות Apigee המקומיות שלכם, לנהל אותם באופן מרכזי ולשלוט בהם.
רכיבים מרכזיים
- מרכז ה-API (Google Cloud): פלטפורמה מרכזית מבוססת-ענן שבה מרוכזים ומנוהלים מטא-נתונים של API ונתוני זמן ריצה.
- מחבר Apigee Hub: רכיב חדש שמותקן לצד סביבת Apigee Edge for Private Cloud. המחבר הזה הוא הסוכן הראשי שאחראי לחילוץ נתונים מ-Apigee Edge לענן פרטי ולפרסום שלהם בצורה מאובטחת ב-Google Cloud.
- מעבדי הודעות (MPs): רכיבי Apigee קיימים שמוגדרים מחדש ל'כתיבה כפולה' של נתוני ניתוח בזמן ריצה למערכת קבצים משותפת ברשת (NFS), כדי שהם יהיו זמינים למחבר של Apigee API Hub.
- מערכת קבצים ברשת (NFS): נפח אחסון משותף שמשמש לאחסון זמני של נתוני ניתוח מ-MP לפני שהמחבר של Apigee API hub מעבד ומעלה אותם.
- Google Cloud Pub/Sub: שירות העברת הודעות שמשמש את המחבר של Apigee API Hub ל-Private Cloud כדי להזרים בצורה מאובטחת מטא-נתונים של API ונתוני זמן ריצה אל API Hub.
- חשבונות שירות של Google Cloud: משמשים לאימות ולהרשאה מאובטחים של המחבר של Apigee API Hub for Private Cloud כדי לקיים אינטראקציה עם שירותי Pub/Sub ו-API Hub.
תהליך השילוב
השילוב מתבצע בתהליך מובנה כדי להבטיח את העברת הנתונים ואת הדיוק שלהם:
- הגדרה ראשונית והקצאת הרשאות:
- השלב הראשון הוא להגדיר פרויקט ב-Google Cloud ולהקצות לו את API Hub.
- יוצרים חשבונות שירות ב-Google Cloud ורושמים את הארגונים שלכם ב-Apigee for Private Cloud ב-API Hub באמצעות יצירה של 'מופעי פלאגין'. בשלב הזה מקבלים נושאי Pub/Sub ייחודיים ומזהים של מופעי פלאגין, שדרושים להגדרה.
- Apigee API hub for Private Cloud connector installation:
- מחבר Apigee API hub לענן פרטי, חבילת RPM, מותקן במכונה וירטואלית ייעודית לצד סביבת Apigee לענן פרטי. לשם כך נדרשת גרסה תואמת של Apigee for Private Cloud.
- הגדרת Apigee API hub for Private Cloudconnector:
- המחבר מוגדר עם פרטים שהתקבלו במהלך יצירת התוסף API Hub (נושאי Pub/Sub, מזהי מופעי תוספים, פרטי חשבון שירות).
- האימות לשירותי Google Cloud (באמצעות מפתחות של חשבונות שירות) ול-Apigee Management Server (באמצעות פרטי כניסה בקידוד base64) מבוצע.
- כאן מוגדר גם הנתיב ל-NFS המשותף.
- הגדרת מעבד ההודעות (MP):
- מעבדי ההודעות של Apigee מתעדכנים כדי לאפשר מנגנון של 'כתיבה כפולה' לנתוני ניתוח. כלומר, רשומות הניתוח נכתבות גם במערכת הניתוח המסורתית וגם בשיתוף ה-NFS המיועד.
- זרימת נתונים:
- מטא-נתונים של API: המחבר של Apigee API hub for Private Cloud שולף מטא-נתונים של API משרת הניהול של Apigee ומפרסם אותם בנושא Pub/Sub של המטא-נתונים שמוגדר ב-Google Cloud, ואז הם מוזנים ל-API hub.
- נתוני זמן ריצה: מעבדי ההודעות כותבים נתוני ניתוח ל-NFS המשותף. המחבר של Apigee Hub עוקב אחרי ה-NFS הזה, מעבד את נתוני זמן הריצה ומפרסם אותם בנושא Pub/Sub של נתוני זמן הריצה שמוגדר ב-Google Cloud, כדי להטמיע אותם ב-API Hub.
- מעקב ופתרון בעיות:
- נקודת קצה (endpoint) של סטטוס מקומי במרכז ה-API של Apigee עבור מחבר ענן פרטי מאפשרת לכם לעקוב אחרי התקדמות ההעלאות של מטא-נתונים ונתוני זמן ריצה.
- יומנים מפורטים זמינים לפתרון בעיות שקשורות להפעלה, להעברת נתונים או לקישוריות.
תלות הדדית:
- המחבר Apigee API Hub for Private Cloud מסתמך על NFS שמותקן בצורה נכונה ונגיש גם לו וגם לכל מעבדי ההודעות.
- כדי לאפשר איסוף נתונים בזמן ריצה, צריך להגדיר את מעבדי ההודעות לכתיבה כפולה ל-NFS.
- כדי שהמחבר יוכל לבצע אימות ולפרסם נתונים, חשוב לוודא שהתפקידים בחשבון השירות של Google Cloud ופרטי המופע של התוסף API Hub נכונים.
השילוב הזה מספק מנגנון חזק להעברת ממשקי Apigee API מקומיים לניהול מרכזי ולשקיפות שמסופקים על ידי API Hub, וכך מאפשר ניהול טוב יותר של ממשקי API ותובנות לגביהם.