שלב 3: יצירת קבוצת סביבות

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

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

יצירת סביבה

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

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

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

  1. בממשק המשתמש של Apigee, עוברים אל Management > Environments (ניהול > סביבות).

    מעבר אל Environments

  2. בחלונית Environments, לוחצים על + Create Environment.
  3. בחלונית Create an environment, מזינים את הפרטים הבאים:

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

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

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

כשהפעולה תסתיים, הסביבה החדשה תוצג בטבלה בחלונית סביבות.

Apigee API

כדי ליצור סביבה באמצעות Create environments 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. יוצרים את משתנה הסביבה הבא:

    ‫Linux / MacOS 

    export ENV_NAME="YOUR_ENV_NAME"

    Windows 

    set ENV_NAME="YOUR_ENV_NAME"

    כאשר:

    • ‫ENV_NAME (חובה) שם הסביבה יכול להכיל אותיות קטנות, מקפים וספרות, והוא חייב להתחיל באות קטנה. השם הזה ישמש כמזהה, ואי אפשר לשנות אותו אחרי שיוצרים את הסביבה.
  4. קוראים ל-Apigee API הבא:

    אין מיקום אחסון נתונים

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

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'"
  }'   "https://$CONTROL_PLANE_LOCATION-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.

  5. כדי לבדוק שהסביבה נוצרה בהצלחה:

    אין מיקום אחסון נתונים

    curl -H "Authorization: Bearer $TOKEN" \
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" \
          "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

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

    [
  "your-environment-name"
]

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

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

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

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

  1. בממשק המשתמש של Apigee, עוברים אל Management > Environments > Environment Groups (ניהול > סביבות > קבוצות סביבות).

    כניסה לדף Environment Groups

  2. בחלונית Environments (סביבות), בוחרים באפשרות Environment Groups (קבוצות סביבות).
  3. לוחצים על + יצירת קבוצת סביבות.
  4. מזינים את הפרטים הבאים:
    • שם קבוצת הסביבות: שם לקבוצת הסביבות. השם צריך להתחיל ולהסתיים בתו אלפאנומרי. השם יכול לכלול עד 63 תווים אלפאנומריים ומקפים. השם צריך להיות שונה מכל שם קיים של קבוצת סביבות בארגון.

    • שמות מארחים: רשימה של שמות מארחים שאפשר להשתמש בהם כדי לקרוא לשרתי proxy. כל שם מארח צריך להיות בשורה נפרדת.

      אפשר גם ללחוץ על הגדרת מאזן העומסים של Google עם הדומיינים האלה. ייפתח הדף Load balancing במסוף Cloud, שבו תוכלו להגדיר איזון עומסים לשמות המארחים.

    • Environments: רשימה אופציונלית של סביבות שייכללו בקבוצת הסביבות.
  5. לוחצים על יצירה.

Apigee API

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

  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. יוצרים את משתני הסביבה הבאים:

    ‫Linux / MacOS 

    export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"

    Windows 

     data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
 data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"

    כאשר:

    • ‫DOMAIN (חובה) זהו שם המארח שכל שרתי ה-proxy שמוצבים בסביבות בקבוצה הזו ישתמשו בו. זה צריך להיות דומיין שאתם מנהלים. הכתובת יכולה להיות הדומיין עצמו, כמו example.com, או שהיא יכולה לכלול תת-דומיין, כמו my-proxies.example.com. אם אין לכם דומיין מנוהל, אתם יכולים להזין פלייס הולדר בשלב הזה. אפשר לשנות את כתובת הדומיין בהמשך.
    • ‫ENV_GROUP (חובה) שם הסביבה יכול להכיל אותיות קטנות, מקפים וספרות, והוא חייב להתחיל באות קטנה. השם הזה ישמש כמזהה ואי אפשר לשנות אותו אחרי שיוצרים את המרחב.
  3. יוצרים את קבוצת הסביבות:

    אין מיקום אחסון נתונים

    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"

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
  4. מקצים את הסביבה לקבוצה החדשה:

    אין מיקום אחסון נתונים

    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"

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
  5. כדי לוודא שקבוצת הסביבות נוצרה בהצלחה, מריצים את פקודת ה-CURL הבאה:

    אין מיקום אחסון נתונים

    curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" \
  "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

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

          {
        "environmentGroups": [
          {
            "name": "your_envgroup_hybrid",
            "hostnames": [
              "apigee.hybrid.com"
            ],
            "createdAt": "1677826235324",
            "lastModifiedAt": "1677826235324",
            "state": "ACTIVE"
          }
        ]
      }
  6. כדי לאחזר את הקבצים המצורפים האחרונים לקבוצת הסביבות החדשה שנוצרה, משתמשים בפקודת ה-CURL הבאה:

    אין מיקום אחסון נתונים

    curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

    מיקום אחסון הנתונים

    curl -H "Authorization: Bearer $TOKEN" \
  "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

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

    
        {
          "environmentGroupAttachments": [
            {
              "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }

השלב הבא

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