בשלב הזה, יוצרים סביבה וקבוצת סביבות.
ב-Apigee, שרתי proxy של API נפרסים בסביבות, שמספקות הקשרים מבודדים לשרתי ה-proxy. הסביבות מאורגנות בקבוצות סביבות, שמספקות שמות מארחים לכל ה-proxy שנפרסו בסביבות בתוך הקבוצה. צריכה להיות לכם לפחות סביבה אחת ולפחות קבוצת סביבות אחת. מידע נוסף זמין במאמר בנושא סביבות וקבוצות של סביבות.
יצירת סביבה
צריך ליצור את הסביבה לפני שיוצרים את קבוצת הסביבות. אפשר ליצור סביבה באמצעות ממשק המשתמש של Apigee או באמצעות ה-API. כדאי להשתמש בממשק המשתמש כדי להכיר אותו.
ממשק המשתמש של Apigee
כדי לגשת לממשק המשתמש ולהוסיף סביבה:
- פותחים את ממשק המשתמש של Apigee. אם זו הפעם הראשונה שאתם מתחברים, מוצגת ב-Hybrid תיבת דו-שיח לבקשת הסכמה. אם תתבקשו לבחור מבין כמה חשבונות, בחרו את החשבון שבו נוצר פרויקט בענן שמופיע בשלב 2: יצירת פרויקט ב-Google Cloud. לוחצים על אישור.
-
מוודאים שהארגון שלכם נבחר מהרשימה הנפתחת של הארגונים. אם הוא לא נבחר, בוחרים אותו מהרשימה הנפתחת, כמו בדוגמה הבאה:
- לוחצים על אדמין > סביבות > סקירה כללית.
מוצג התצוגה המקדימה של סביבות, ללא סביבות (עדיין):
- לוחצים על +סביבה.
מופיעה תיבת הדו-שיח סביבה חדשה:
- בתיבת הדו-שיח סביבה חדשה, מזינים את הפרטים הבאים:
- שם תצוגה (חובה): שם ידידותי לסביבה שמוצג בממשק המשתמש. לדוגמה, "הסביבה הראשונה שלי" או "בדיקה". בניגוד לשם הסביבה, השם המוצג יכול לכלול אותיות רישיות ותווים מיוחדים אחרים.
- שם הסביבה (חובה): השם התוכניתי של הסביבה, שנקרא גם מזהה הסביבה.
לדוגמה, my-environment או test.
השם המוצג ושם הסביבה יכולים להיות שונים.
- תיאור (אופציונלי): מידע נוסף על הסביבה שרוצים להוסיף כתזכורת למטרה של הסביבה. לדוגמה, "נוצר במהלך ההתקנה הראשונית".
- לוחצים על יצירה.
מערכת Apigee יוצרת את הסביבה החדשה ומציינת שהיא בהמתנה להקצאת משאבים:
אחרי כמה רגעים, הסטטוס משתנה לprovisioned:
אבל עוד לא סיימתם. צריך גם להוסיף את הסביבה החדשה לקובץ
overrides.yamlשל זמן הריצה, אבל קודם צריך להתקין את זמן הריצה.
הדפדפן עובר לדף הנחיתה הראשי של ממשק המשתמש:
Apigee API
כדי ליצור סביבה באמצעות ממשק API ליצירת סביבות, מבצעים את השלבים הבאים:
- פותחים טרמינל במכשיר שבו משתמשים לניהול Apigee.
-
בשורת הפקודה, מריצים את הפקודה הבאה כדי לקבל את פרטי הכניסה לאימות ב-
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%
האסימון יוצג כמחרוזת מקודדת.
- יוצרים את משתנה הסביבה הבא:
Linux / MacOS
export ENV_NAME="YOUR_ENV_NAME"
Windows
set ENV_NAME="YOUR_ENV_NAME"
כאשר:
-
ENV_NAME(חובה) שם הסביבה יכול להכיל אותיות קטנות, מקפים ומספרים, והוא חייב להתחיל באות קטנה. השם הזה ישמש כמזהה ואי אפשר לשנות אותו אחרי שיוצרים את הסביבה.
-
- שולחים קריאה ל-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"אם בקשת היצירה מצליחה, 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. - כדי לוודא שהסביבה נוצרה בהצלחה:
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"אם בקשת היצירה מצליחה, Environments API מגיב בהודעה שדומה לזו:
[ "your-environment-name" ]
יצירת קבוצת סביבות
עכשיו יוצרים קבוצת סביבות ומקצים לה את הסביבה שיצרתם.
ממשק המשתמש של Apigee
כדי ליצור קבוצת סביבות באמצעות ממשק המשתמש של Apigee, מבצעים את השלבים הבאים:
- פותחים את ממשק המשתמש של Apigee.
- מוודאים שהארגון שלכם נבחר מהרשימה הנפתחת של הארגונים. אם הוא לא נבחר, בוחרים אותו מהרשימה הנפתחת.
-
לוחצים על ניהול > סביבות > קבוצות.
מוצגת התצוגה Environment Groups Overview (סקירה כללית של קבוצות סביבות), עם כל קבוצות הסביבות שנוצרו:
-
לוחצים על + קבוצת סביבות.
מופיעה תיבת הדו-שיח Add an Environment Group (הוספת קבוצת סביבות).
- מזינים שם ולוחצים על הוספה.
-
מציבים את הסמן מעל קבוצת הסביבות החדשה ולוחצים על עריכה .
מוסיפים שם מארח שכל השרתים הפרוקסי שנפרסו בסביבות בקבוצה הזו ישתמשו בו. זה צריך להיות דומיין שיש לכם הרשאת ניהול לגביו. שם המארח יכול להיות הדומיין עצמו, כמו
example.com, או שהוא יכול לכלול תת-דומיין, כמוmy-proxies.example.com.אם אתם צריכים לרשום דומיין, תוכלו להיעזר ברשם דומיינים כמו Google Domains.
- לוחצים על הוספה (+).
- מופיעה תיבת הדו-שיח הוספת סביבה.
- בוחרים סביבה מהרשימה ולוחצים על הוספה.
הדפדפן עובר לדף הנחיתה הראשי של ממשק המשתמש של Apigee.
Apigee API
כדי ליצור קבוצת סביבות באמצעות Apigee API:
-
בשורת הפקודה, מריצים את הפקודה הבאה כדי לקבל את פרטי הכניסה לאימות ב-
gcloud:Linux / MacOS
TOKEN=$(gcloud auth print-access-token)
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a - יוצרים את משתני הסביבה הבאים:
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(חובה) שם הסביבה יכול להכיל אותיות קטנות, מקפים ומספרים, והוא חייב להתחיל באות קטנה. השם הזה ישמש כמזהה ואי אפשר לשנות אותו אחרי היצירה.
-
- יוצרים את קבוצת הסביבה:
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 '{ "environment": "'"$ENV_NAME"'", }' \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments" - כדי לוודא שקבוצת הסביבות נוצרה בהצלחה, מריצים את פקודת ה-CURL הבאה:
curl -H "Authorization: Bearer $TOKEN" \ "https://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" } ] } - כדי לאחזר את הקבצים המצורפים העדכניים ביותר לקבוצת הסביבות שנוצרה, משתמשים בפקודת ה-CURL הבאה:
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"היצירה והצירוף של קבוצת הסביבות הצליחו אם בתוצאה מופיע ערך גיבוב ייחודי, כמו שמוצג בפלט התגובה לדוגמה שבהמשך:
{ "environmentGroupAttachments": [ { "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6", "environment": "your_envtest_hybrid", "createdAt": "1677826263567", "environmentGroupId": "your_envgroup_hybrid" } ] }
השלב הבא
כדי להמשיך בהתקנה, עוברים אל חלק 2: הגדרת זמן ריצה היברידי.