יצירת סביבות

במאמר הזה מוסבר איך ליצור סביבות חדשות ב-Apigee hybrid. מידע נוסף זמין במאמר About environments and environment groups.

מידע על יצירת סביבה

תהליך יצירת הסביבה כולל שני שלבים:

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

השלבים להוספת סביבה מתוארים במאמר בנושא הוספה והגדרה של סביבה, שלב 5: הוספת סביבה ו ציון שינויים בהגדרות.

איך יוצרים סביבה

  1. יוצרים סביבה חדשה אחת או יותר בממשק המשתמש של Apigee או באמצעות Create environments API. השלבים הבסיסיים מפורטים במאמר שלב 5: הוספת סביבה.

  2. מוסיפים הגדרה חדשה של סביבה למאפיין envs[] בקובץ ההחלפות. שימו לב שהמאפיין הוא מערך, ולכן אפשר להוסיף לו יותר מהגדרת סביבה אחת. נותנים לסביבה החדשה את אותו שם שנתתם לסביבה שיצרתם בממשק המשתמש. לדוגמה, בהגדרה הבאה מוגדרות שתי סביבות: test ו-prod:

    namespace: my-namespace
org: my-organization
...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json

  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json
...
  3. מחילים את השינויים על האשכול:

    Helm

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

    לדוגמה:

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server

      ‫ENV_RELEASE_NAME הוא שם שמשמש למעקב אחרי התקנות ושדרוגים של התרשים apigee-env. שמות של Helm release חייבים להיות ייחודיים בהתקנת Apigee Hybrid. אם שם הסביבה שלכם ייחודי, אפשר להשתמש באותו שם כמו ENV_NAME. עם זאת, אם השם של הסביבה ושל קבוצת הסביבות זהה, צריך להזין שם ייחודי לכל מהדורה של Helm. לדוגמה, אם לשניהם קוראים dev אפשר להשתמש בשמות כמו dev-env-release ו-dev-envgroup-release.

      מידע נוסף על מהדורות ב-Helm זמין במאמר שלושה מושגים חשובים במאמרי העזרה של Helm.

    סביבת test:

    helm upgrade test-release apigee-env/ \
  --namespace apigee \
  --atomic \
  --set env=test \
  -f OVERRIDES_FILE.yaml

    סביבת prod:

    helm upgrade prod-release apigee-env/ \
  --namespace apigee \
  --set env=prod \
  --atomic \
  -f OVERRIDES_FILE.yaml

    apigeectl

    באמצעות apigeectl אפשר להחיל את השינויים על כל סביבה בנפרד עם הדגל --env ENV_NAME, או על כל הסביבות בו-זמנית עם הדגל --all-envs. לדוגמה:

    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

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