שלב 5: יצירה של קבוצת סביבות

בשלב הזה, יוצרים סביבה וקבוצת סביבות.

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

יצירת סביבה

צריך ליצור את הסביבה לפני שיוצרים את קבוצת הסביבות. אפשר ליצור סביבה באמצעות ממשק המשתמש של Apigee hybrid או באמצעות ה-CLI. כדאי להשתמש בממשק המשתמש כדי להכיר אותו.

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

כדי לגשת לממשק המשתמש ההיברידי ולהוסיף סביבה, מבצעים את השלבים הבאים:

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

    2. הדפדפן יעבור לדף הנחיתה הראשי של ממשק המשתמש ההיברידי:

    דף הנחיתה בממשק המשתמש ההיברידי של Apigee, שכולל ניווט בצד ימין ותמונות גדולות שהן קישורים.

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

    רשימה של ארגונים שהופעלה בהם הגדרת היברידי

  3. לוחצים על אדמין > סביבות > סקירה כללית.

    תפריט ממשק המשתמש של Apigee Hybrid שבו האפשרויות Admin,‏ Environments ו-Overview מורחבות

    מוצג התצוגה המקדימה של סביבות, ללא סביבות (עדיין):

    התצוגה 'סביבות' ריקה (אין סביבות)

  4. לוחצים על +סביבה.

    מופיעה תיבת הדו-שיח סביבה חדשה:

    תיבת הדו-שיח החדשה של הסביבה

  5. בתיבת הדו-שיח סביבה חדשה, מזינים את הפרטים הבאים:
    1. שם תצוגה (חובה): שם ידידותי לסביבה שמוצג בממשק המשתמש. לדוגמה, "הסביבה הראשונה שלי" או "בדיקה". בניגוד לשם הסביבה, השם המוצג יכול לכלול אותיות רישיות ותווים מיוחדים אחרים.
    2. שם הסביבה (חובה): השם התוכניתי של הסביבה, שנקרא גם מזהה הסביבה.

      לדוגמה, my-environment או test.

      השם המוצג ושם הסביבה יכולים להיות שונים.

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

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

    הודעת הסטטוס Pending Provisioning (הקצאת הרשאות בהמתנה)

    אחרי כמה רגעים, הסטטוס משתנה לprovisioned:

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

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

‫CLI של gcloud

כדי ליצור סביבה באמצעות ממשק API ליצירת סביבות, מבצעים את השלבים הבאים:

  1. פותחים טרמינל במכשיר שבו משתמשים לניהול Apigee.

  2. בשורת הפקודה, מריצים את הפקודה הבאה כדי לקבל את פרטי הכניסה לאימות ב-gcloud:

    ‫Linux / MacOS 

    export TOKEN=$(gcloud auth print-access-token)

    כדי לוודא שהטוקן אוכלס, משתמשים ב-echo, כמו בדוגמה הבאה:

    echo $TOKEN

    האסימון יוצג כמחרוזת מקודדת.

    Windows 

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

    כדי לוודא שהטוקן אוכלס, משתמשים ב-echo, כמו בדוגמה הבאה:

    echo %TOKEN%

    האסימון יוצג כמחרוזת מקודדת.
  3. מוודאים שמשתני הסביבה הנדרשים מוגדרים באמצעות הפקודות הבאות: 
    echo ${PROJECT_ID}
echo ${ENV_NAME}
echo ${ENV_DISPLAY_NAME}
echo ${ORG_NAME}
echo ${ENV_DESCRIPTION}

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

    • ‫ENV_NAME (חובה) הוא המזהה התוכניתי של הסביבה שלכם. שם הסביבה יכול להכיל אותיות קטנות, מקפים ומספרים, והוא חייב להתחיל באות קטנה. השם הזה ישמש כמזהה ואי אפשר לשנות אותו אחרי שיוצרים את המרחב. 
      export ENV_NAME=environment_name
    • ENV_DISPLAY_NAME (חובה) הוא השם הידידותי למשתמש של הסביבה. הערך הזה לא צריך להיות ייחודי, והוא יכול לכלול רווחים ותווים מיוחדים. לדוגמה, "My Example Environment". 
      ENV_DISPLAY_NAME=friendly_name
    • ‫ORG_NAME (חובה) הוא מזהה הארגון. מוודאים שהגדרתם את משתנה הסביבה ORG_NAME משלב 4: יצירת ארגון: 
      echo $ORG_NAME
    • ‫ENV_DESCRIPTION (אופציונלי) הוא מידע על הסביבה שבה רוצים להשתמש כדי להזכיר את המטרה שלה. לדוגמה, "Example environment for Apigee Hybrid instructions". 
      ENV_DESCRIPTION=description_text
  4. שולחים בקשת POST מאומתת אל Create environments API.

    בדוגמה הבאה מוצגת מבנה הבקשה שיוצרת סביבה, באמצעות הפקודה הבאה:

    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'",
    "displayName": "'"$ENV_DISPLAY_NAME"'",
    "description": "'"$ENV_DESCRIPTION"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    אם בקשת היצירה מצליחה, Environments API אמור להשיב בהודעה שדומה לזו:

    {
  "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "organizations/hybrid-example/environments/example-env",
    "state": "IN_PROGRESS"
  }
}

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

יצירת קבוצת סביבות

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

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

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

  1. פותחים את ממשק המשתמש של Apigee.

    2. הדפדפן עובר לדף הנחיתה הראשי של ממשק המשתמש ההיברידי.

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

    מוצגת התצוגה Environment Groups Overview (סקירה כללית של קבוצות סביבות), עם כל קבוצות הסביבות שנוצרו:

    תצוגת קבוצות הסביבות, שבה מוצגות כל הקבוצות שנוצרו

  4. לוחצים על + קבוצת סביבות.

    מופיעה תיבת הדו-שיח Add an Environment Group (הוספת קבוצת סביבות).

    תיבת דו-שיח להוספת קבוצת סביבות עם שדה שם ריק

  5. מזינים שם ולוחצים על הוספה.

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

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

    אם אתם צריכים לרשום דומיין, תוכלו להיעזר ברשם דומיינים כמו Google Domains.

    7. חלון עריכת קבוצת הסביבות שלא מוקצות בו סביבות

  7. לוחצים על הוספה (+).
  8. מופיעה תיבת הדו-שיח הוספת סביבה.

    9. תיבת דו-שיח להוספת סביבה עם רשימה של סביבות זמינות

  9. בוחרים סביבה מהרשימה ולוחצים על הוספה.

‫CLI של gcloud

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

  1. בשורת הפקודה, מריצים את הפקודה הבאה כדי לקבל את פרטי הכניסה לאימות ב-gcloud:

    ‫Linux / MacOS 

    TOKEN=$(gcloud auth print-access-token)

    Windows 

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. מוודאים שמשתנה הסביבה DOMAIN מוגדר כמו בדוגמה הבאה: 
    echo $DOMAIN

    זהו שם המארח שכל שרתי ה-proxy שנפרסו בסביבות בקבוצה הזו ישתמשו בו. זה צריך להיות דומיין שיש לכם הרשאת ניהול לגביו. שם המארח יכול להיות הדומיין עצמו, כמו example.com, או שהוא יכול לכלול תת-דומיין כמו my-proxies.example.com.

    אם הוא לא מוגדר, צריך ליצור אותו עם הדומיין שמתכננים להשתמש בו להתקנת Apigee Hybrid. לדוגמה: 

    export DOMAIN=domain-name.com
  3. מוודאים שמשתנה הסביבה ENV_NAME מוגדר לסביבה שיצרתם בשלבים הקודמים. לדוגמה: 
    echo $ENV_NAME
  4. יוצרים משתנה סביבה לשם קבוצת הסביבות הרצויה. לדוגמה: 
    export ENV_GROUP=environment-group-name
  5. יוצרים את קבוצת הסביבות באמצעות הפקודה הבאה: 
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
  6. מקצים את הסביבה לקבוצה החדשה באמצעות הפקודה הבאה: 
    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

השלב הבא

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