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

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

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

יצירת סביבה

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

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

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

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

    כניסה לדף Environments

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

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

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

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

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

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"

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

    {
  "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"

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

    [
  "your-environment-name"
]

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

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

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

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

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

    כניסה לדף Environment Groups

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

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

      אפשר גם ללחוץ על הגדרת Google Load Balancer עם הדומיינים האלה. הפעולה הזו פותחת את הדף 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"

    אם בקשת היצירה מצליחה, ה-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: הגדרת סביבת זמן הריצה ההיברידית.