ניהול מופעים

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

יצירת מופע חדש

כדי ליצור מופע חדש, אפשר להשתמש ב-Instances API או בממשק המשתמש של Apigee. לכל מופע נדרשים:

  • מפתח הצפנה משלו לדיסק ברשת. ‫Apigee ממליצה ליצור גם מחזיק מפתחות נפרד למופע החדש. מידע נוסף זמין במאמר בנושא מפתחות ההצפנה של Apigee.
  • טווחי CIDR משלהם שאינם חופפים, /22 ו-/28, לצורך קישור בין רשתות שכנות (peering). אי אפשר לשתף את הטווחים בין מופעים.

ממשק המשתמש של Apigee

כדי ליצור מכונה חדשה בממשק המשתמש של Apigee:

  1. במסוף Google Cloud , נכנסים לדף Apigee > Management > Instances.

    כניסה לדף Instances

    בחלונית Instances (מופעים) מוצגת רשימה של מופעים קיימים.

  2. לוחצים על ‎+ Create. יכול להיות שיהיה עיכוב בזמן שממשק המשתמש יקבע אם לארגון שלכם יש את ההרשאות המתאימות ליצירת מכונה חדשה.

    מוצג הדף Create new instance.

  3. מזינים את הפרטים של המופע החדש בשדות:
    שדה חובה תיאור
    Runtime hosting location חובה בוחרים את האזור שבו רוצים ליצור את המכונה החדשה. אי אפשר ליצור מופע חדש באזור שכבר יש בו מופע. מידע נוסף על עבודה עם כמה אזורים זמין במאמר שימוש בכמה אזורים.
    Name חובה

    מזינים את המזהה של המופע החדש.

    ערך ברירת המחדל הוא השם של אזור האירוח של זמן הריצה שבחרתם, אבל אתם יכולים לשנות אותו לכל שם משמעותי שתרצו, כל עוד אתם פועלים לפי כללי מתן השמות:

    • אורך מינימלי של 2.
    • אורך מקסימלי של 32 תווים.
    • אפשר להשתמש רק באותיות קטנות, במספרים ובמקפים (לפי התבנית /^[a-z0-9\-]+$/).
    • השם חייב להתחיל באות, ולא יכול להתחיל בספרות או במקפים.
    • השם חייב להסתיים בספרה או באות, ולא יכול להסתיים במקף.
    • השם חייב להיות ייחודי בארגון.
    IP range allocation חובה

    מציינים איך רוצים להקצות טווח כתובות IP. תוכלו לבחור בין האפשרויות הבאות:

    • אוטומטי (מומלץ) – מערכת Apigee בוחרת טווח CIDR זמין עם גודל קידומת של ‎ /22. לא נדרשת פעולה נוספת מצידך.
    • מותאם אישית – בתרחישי שימוש מתקדמים, יכול להיות שתצטרכו לציין בדיוק את טווח כתובות ה-IP שבו אתם רוצים ש-Apigee ישתמש. במקרים כאלה, מציינים טווח IP מותאם אישית, וגודל הקידומת שלו חייב להיות ‎ /22. הטווח צריך להיות זמין כחלק מחיבור פרטי בין הפרויקט שלכם לבין Apigee.
    Disk encryption key חובה

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

    1. לוחצים על Create key.
    2. בוחרים אוסף מפתחות, או שאם הוא לא קיים, מפעילים את האפשרות יצירת אוסף מפתחות, מזינים שם לאוסף המפתחות ובוחרים מיקום לאוסף המפתחות. שמות של אוספי מפתחות יכולים להכיל אותיות, מספרים, קווים תחתונים (_) ומקפים (-). אי אפשר לשנות את השם של אוסף מפתחות או למחוק אותו.
    3. לוחצים על Continue.
    4. יוצרים מפתח. מזינים שם ורמת הגנה. שימו לב ששמות של מפתחות יכולים להכיל אותיות, מספרים, קווים תחתונים (‎_) ומקפים (‎-). אי אפשר לשנות את השם של מפתחות או למחוק אותם. רמת ההגנה תוכנה היא בחירה טובה. זו ברירת המחדל שמשמשת את Cloud KMS, אבל אפשר לשנות אותה אם רוצים.
    5. לוחצים על המשך ובודקים את הבחירות.
    6. לוחצים על יצירה.
    7. לוחצים על Grant כדי לתת לחשבון השירות הרשאה להצפנה/פענוח באמצעות המפתח שנבחר.
    Environments אופציונלי

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

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

    הוספת סביבות כשיוצרים מופע חדש היא אופציונלית. אם לא מוסיפים אותם עכשיו, אפשר להשתמש ב-Instances attachment create API או בממשק המשתמש כדי להוסיף ולהסיר אותם מאוחר יותר. מידע נוסף מופיע במאמר בנושא צירוף או הסרה של סביבה.
    Accepted projects אופציונלי לוחצים על Add accepted project (הוספת פרויקט שאושר) כדי לבחור פרויקט אחד או יותר ב-Cloud. הפרויקטים שנבחרו יכולים להתחבר באופן פרטי לצירוף השירות של המופע שלכם. כברירת מחדל, הפרויקט שמשויך לארגון שלכם ב-Apigee נכלל ברשימה הזו.
    Enable logging אופציונלי לוחצים על המתג הפעלת רישום ביומן כדי להפעיל את יומני הגישה של Cloud Logging לנתונים שנכנסים למופע. התכונה הזו מאפשרת לכם לראות את היומנים שנוצרו על ידי שערים של תעבורת נתונים נכנסת (ingress) בתשתית Apigee, כמו מאזן עומסים של אפליקציות (ALB) חיצוני או שער Anthos, כדי לעזור לכם בפתרון בעיות בקריאות ל-API של Apigee.

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

    אם רוצים לכלול את כל היומנים, בלי קשר לקוד התגובה של HTTP, בוחרים באפשרות None (all HTTP responses).

    כדי ליצור מסנן בהתאמה אישית, לוחצים על Custom ומזינים את המסנן בפורמט הבא:

    status_code > XX && status code <= YY

    לדוגמה:

    status_code >= 500 && status_code < 504

    אם הארגון שלכם לא יכול ליצור מופע חדש, אתם צריכים לפנות אל צוות המכירות של Apigee.

  4. לוחצים על יצירה.

    ‫Apigee מתחיל פעולה ממושכת שיכולה להימשך 20 דקות או יותר. כשהתהליך יסתיים, המופע החדש יופיע ברשימת המופעים בממשק המשתמש של Instances.

Apigee API

אם הקצאתם את Apigee בלי קישור בין רשתות VPC שכנות (peering), תוכלו לעיין בשלבים להקצאת משאבים בלי קישור בין רשתות VPC שכנות (peering) במאמר יצירת מופע של זמן ריצה.

אם הקצאתם את Apigee עם קישור בין רשתות VPC, תוכלו לעיין בקטע יצירת מכונת זמן ריצה בשלבי הקצאת הקישור בין רשתות VPC.

צירוף סביבות למופע או הסרה של סביבות ממופע

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

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

כדי לצרף או להסיר סביבה ממופע באמצעות ממשק המשתמש של Apigee:

  1. במסוף Google Cloud , נכנסים לדף Apigee > Management > Instances.

    כניסה לדף Instances

  2. לוחצים על המופע שרוצים לערוך.

  3. בדף פרטי האירוע, לוחצים על עריכה.
  4. בדף Edit Instance (עריכת מופע), לוחצים על השדה Environments (optional) (סביבות (אופציונלי)) ובוחרים את הסביבה שרוצים לצרף למופע, או מבטלים את הבחירה בסביבה שרוצים להסיר.
  5. לוחצים על OK.
  6. לוחצים על Save כדי לשמור את השינויים.

בנוסף לשימוש בממשק המשתמש, אפשר גם לצרף סביבות למופע באמצעות Instances attachment create API. דוגמה מופיעה במאמר בנושא יצירת סביבה במסמכי התיעוד בנושא הקצאת משאבים דרך שורת הפקודה.

עריכת רשימת הפרויקטים שאושרו

אפשר להוסיף פרויקטים לרשימה פרויקטים שאושרו או להסיר אותם ממנה:

  1. במסוף Google Cloud , נכנסים לדף Management > Instances.

    כניסה לדף Instances

  2. לוחצים על המופע שרוצים לערוך.

  3. בדף פרטי האירוע, לוחצים על עריכה.
  4. בקטע Accepted projects (פרויקטים שאושרו) בדף Edit Instance (עריכת מופע), לוחצים על Delete (מחיקה) ליד פרויקט כדי להסיר אותו. כדי להוסיף פרויקט, לוחצים על הוספת פרויקט שאושר ומזינים את מזהה הפרויקט שרוצים להוסיף.
  5. לוחצים על Save כדי לשמור את השינויים.

הפעלה או השבתה של יומני גישה (ingress) למופע

אחרי שיוצרים מופע, אפשר להפעיל או להשבית את יומני הגישה של תעבורת הנתונים הנכנסת (ingress) ב-Cloud Logging עבור המופע:

  1. במסוף Google Cloud , נכנסים לדף Management > Instances.

    כניסה לדף Instances

  2. לוחצים על המופע שרוצים לערוך.

  3. בדף פרטי האירוע, לוחצים על עריכה.
  4. בדף Edit Instance, לוחצים על המתג Enable logging כדי להשבית את התכונה.
  5. לוחצים על Save כדי לשמור את השינויים.

מחיקת מכונה

אפשר להשתמש בממשק המשתמש של Apigee כדי למחוק מופע קיים, כמו שמתואר בקטע הזה. אפשר גם למחוק מופע באמצעות Instances API.

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

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

הנתונים הבאים מאוחסנים במופע Apigee ויימחקו אם תמחקו את המופע:

סוג הנתונים תיאור
מערכת ניהול מפתחות (KMS) נתוני KMS כוללים מוצרי API, מפתחים, אפליקציות למפתחים, טוקנים של OAuth (כולל טוקנים של גישה, טוקנים של רענון וקודי הרשאה) ומפתחות API. כדי לאחזר את הנתונים שרוצים לשמור, אפשר להשתמש במדיניות AccessEntity או ב-Apigee API שקשור אליה.
מפת מפתח/ערך (KVM) כל נתון שאפשר ליצור או לנהל באמצעות מדיניות KVM. איך מאחזרים זוגות של מפתחות/ערכים
מכסה הגדרות מכסה, קטגוריות ומונים.
מטמון סביבתי כל הנתונים שנשמרו במטמון.

כדי למחוק מופע של Apigee באמצעות ממשק המשתמש של Apigee:

  1. במסוף Google Cloud , נכנסים לדף Management > Instances.

    כניסה לדף Instances

  2. לוחצים על המופע שרוצים למחוק.
  3. בדף Instance Details (פרטי האירוע), לוחצים על Delete (מחיקה).