יצירת סביבות

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

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

יצירת סביבה היא תהליך דו-שלבי:

  • יוצרים סביבה במישור הניהול באמצעות ממשק המשתמש או 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 צריכים להיות ייחודיים בהתקנת Apigee Hybrid. אם שם הסביבה שלכם ייחודי, הוא יכול להיות זהה ל-ENV_NAME. עם זאת, אם שם הסביבה ושם קבוצת הסביבות זהים, צריך להזין שם ייחודי של מהדורת Helm לכל אחת מהן. לדוגמה, אם שניהם נקראים dev, אפשר להשתמש בשמות כמו dev-env-release ו-dev-envgroup-release.

      מידע נוסף על מהדורות ב-Helm זמין במאמר Three big concepts (שלושה מושגים חשובים) במאמרי העזרה של 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 בחומר העזר בנושא מאפייני ההגדרה.