עבודה עם סביבות

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

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

בקטע הזה מוסבר איך ליצור, לערוך ולמחוק סביבות באמצעות Apigee.

מידע על סביבות

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

סביבות ומופעים

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

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

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

יצירת סביבות

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

יצירת סביבה חדשה בממשק המשתמש

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

  1. במסוף Google Cloud , עוברים לדף Apigee > Management > Environments.

    מעבר אל Environments

  2. בחלונית סביבות, לוחצים על + יצירת סביבה.
  3. בחלונית Create an environment, מזינים את הפרטים הבאים:
    • בחירת סוג הסביבה: אם אתם לקוחות עם תשלום לפי שימוש, לוחצים על בחירה כדי לבחור את סוג הסביבה שרוצים ליצור: בסיסית, בינונית או מקיפה.

      הבחירה של סוג הסביבה לא רלוונטית ללקוחות עם מינוי ולא תופיע בממשק המשתמש.

    • שם: שם הסביבה הפרוגרמטית. אי אפשר לשנות את השם אחרי שיוצרים אותו.

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

    • השם המוצג: השם של הסביבה שמוצג בממשק המשתמש.
    • תיאור: אופציונלי. תיאור של הסביבה.
    • ‫Instance: אופציונלי. בוחרים את מופע Apigee שיטען, יפרוס וישרת תנועה עבור הסביבה.
    • ‫Environment group (קבוצת סביבות): אופציונלי. מסמנים את תיבת הסימון כדי להוסיף את הסביבה החדשה לקבוצת סביבות קיימת. לוחצים על אישור.
    • סוג הפריסה: בוחרים אם רוצים לפרוס שרתי proxy נפרדים ל-API או ארכיון של סביבת ההגדרה של שרתי ה-proxy ל-API. מידע נוסף זמין במאמר בנושא סוגי פריסות נתמכים.
  4. לוחצים על יצירה.

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

כל סביבה חדשה צריכה להיות מצורפת למופע של Apigee ולקבוצת סביבות.

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

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

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

יצירת סביבה חדשה באמצעות Apigee API

בקטע הזה מוסבר איך ליצור סביבה חדשה באמצעות Apigee API.

רוב השלבים בתהליך הזה מפעילים פעולות ארוכות טווח שיכולות להימשך כמה דקות.

כדי ליצור סביבה חדשה באמצעות Apigee API:

  1. יוצרים את הסביבה החדשה באמצעות Create environments API.
  2. מצרפים את הסביבה למופע של סביבת ההרצה באמצעות Instances attachment API.
  3. יוצרים קבוצת סביבות אם עדיין אין לכם אחת. כדי לעשות את זה, משתמשים ב-Create environment groups API.
  4. מצרפים את הסביבה החדשה לקבוצת הסביבות באמצעות Environment group attachment API.

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

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

עריכת סביבות

בקטע הזה מוסבר איך לערוך סביבות קיימות בממשק המשתמש של Apigee וב-Apigee API.

עריכת סביבות בממשק המשתמש של Apigee

אתם יכולים לשנות את המאפיינים הבאים של סביבה קיימת בממשק המשתמש של Apigee:

  • שם לתצוגה: מזינים שם חדש לתצוגה של הסביבה.
  • תיאור: מזינים תיאור חדש לסביבה.
  • קבוצת סביבות: מבטלים את הסימון של התיבה שנבחרה קודם ומסמנים את התיבה של קבוצת הסביבות החדשה.

כדי לערוך סביבה בממשק המשתמש של Apigee:

  1. במסוף Google Cloud , עוברים לדף Apigee > Management > Environments.

    מעבר אל Environments

  2. בוחרים את הפרויקט עם הסביבות שרוצים לעדכן.
  3. מחפשים את השורה של הסביבה שרוצים לערוך, לוחצים על פעולות > עריכה. מוצגת תיבת הדו-שיח עריכת סביבה.
  4. בחירת סוג הסביבה: אם אתם לקוחות עם תשלום לפי שימוש, בוחרים באפשרות בקטע בחירת סוג הסביבה כדי לשנות את סוג הסביבה. האפשרויות הן בסיסית, בינונית או מקיפה.

    הבחירה של סוג הסביבה לא רלוונטית ללקוחות עם מינוי ולא תופיע בממשק המשתמש.

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

עריכת סביבות באמצעות Apigee API

כדי לערוך סביבה קיימת באמצעות Apigee API, משתמשים ב-Get environments API כדי לקבל את רשימת המאפיינים הנוכחיים שאפשר לשנות, וב-Update environments API כדי להגדיר או לשנות אותם.

הגדרת העברת בקשות דרך שרת proxy בסביבה

כדי להגדיר העברה של בקשות דרך שרת proxy, צריך להגדיר את הערך forwardProxyUri לסביבה באמצעות environments API.

השבתה של שרת proxy קדימה עבור שרת proxy בסביבה

אם התנועה ליעד ספציפי של proxy ל-API צריכה לעבור ישירות ליעד הבק-אנד, בלי לעבור דרך שרת ה-proxy להעברה, צריך להגדיר את המאפיין הבא ב-TargetEndpoint כדי לבטל את שרת ה-proxy להעברת HTTP:

<Property name="use.proxy">false</Property>

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

מגדירים את use.proxy ל-true לכל TargetEndpoint שרוצים להעביר דרך HTTP forward proxy:

<Property name="use.proxy">true</Property>

מחיקת סביבות

לפני שמוחקים סביבה, חשוב לקרוא את הנקודות הבאות:

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

מחיקת סביבה באמצעות ממשק המשתמש של Apigee

כדי למחוק סביבה בממשק המשתמש של Apigee:

  1. במסוף Google Cloud , עוברים לדף Apigee > Management > Environments.

    מעבר אל Environments

  2. בוחרים את הפרויקט עם הסביבות שרוצים למחוק.
  3. מחפשים את השורה של הסביבה שרוצים למחוק, לוחצים על פעולות > מחיקה.

מחיקת סביבה באמצעות Apigee API

כדי למחוק סביבה, משתמשים ב-Delete environments API.