יצירת סביבות

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