תחילת העבודה עם gcloud ב-Apigee

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

‫gcloud apigee CLI מאפשר לכם לבצע את הפעולות הבאות:

  • צפייה בממשקי proxy ל-API
  • יצירה וניהול של מוצרי API
  • פריסה וביטול פריסה של שרתי proxy של API, והצגת פרטי הפריסה
  • הצגת מידע על מפתחים ואפליקציות
  • רשימת הסביבות והארגונים
  • ניהול אפליקציות של צד שלישי שקוראות ל-API proxies של Apigee

בנוסף, באמצעות ה-CLI של gcloud beta apigee אפשר לפרוס ולנהל ארכיונים בסביבת Apigee.

בקטעים הבאים מוסבר איך להתקין את ממשקי ה-CLI‏ gcloud apigee ו-gcloud beta apigee, להעניק להם הרשאה ולהשתמש בהם, וגם איך להגדיר משתני סביבה (אופציונלי).

לפני שמתחילים

מוודאים שאתם עומדים בדרישות המוקדמות לשימוש ב-Apigee, כולל התקנה של Google Cloud SDK.

התקנת רכיבי gcloud beta apigee

כדי לגשת לפקודות של gcloud beta apigee, צריך להתקין את רכיב הבטא המלא של gcloud, באופן הבא:

gcloud components install beta

כדי לוודא שרכיב הבטא הותקן, מזינים את הפקודה הבאה:

gcloud components list

רכיב הבטא אמור להופיע ברשימה, כמו שמוצג כאן:

סטטוס שם מזהה גודל
מותקן פקודות בטא gcloud beta < 1MiB

מידע נוסף מופיע במאמר בנושא ניהול רכיבי SDK.

אישור גישה ל-gcloud

נותנים הרשאת גישה ל-gloud CLI באמצעות השלבים שמתוארים במאמר הרשאות לכלים של Cloud SDK.

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

gcloud init

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

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

gcloud auth login

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

מידע נוסף על הרשאות וביטול גישה ל-CLI של gcloud זמין במאמר בנושא פרטי כניסה.

הגדרת משתני סביבה לפקודות gcloud

בדוגמאות של Apigee API ו-CLI של gcloud שמופיעות במאמרים השונים, נעשה שימוש במשתנה סביבה אחד או יותר שמוגדרים בטבלה הבאה.

אם מגדירים מראש את משתני הסביבה לערכים משמעותיים בסביבה שלכם, אפשר להעתיק ולהדביק את בקשות הדוגמה כדי להריץ אותן בסביבה שלכם עם שינויים מינימליים או ללא שינויים בכלל.

משתנה הסביבה תיאור
$API השם של ה-proxy ל-API.
$APIPRODUCT השם של מוצר ה-API.
$APP מזהה של אפליקציה.
$DEVELOPER_EMAIL כתובת האימייל של המפתח.
$ENV שם הסביבה, למשל test או prod.
$ID מזהה המשאב.
$KEY טוקן צרכן.
$NAME השם של המשאב.
$ORG הארגון שלכם ב-Apigee.
$REV מספר הגרסה של ה-proxy ל-API.
$SHAREDFLOW השם של התהליך המשותף.
$TYPE סוג המשאב.

שימוש ב-CLI של gcloud

משתמשים ב-gcloud CLI באופן הבא: 

gcloud apigee GROUP [GCLOUD_WIDE_FLAG …]

למידע נוסף על קבוצות הפקודות והדגלים הזמינים, ראו gcloud apigee.

לדוגמה, הפקודה הבאה מציגה רשימה של שרתי proxy של API בארגון: 

gcloud apigee apis list --organization=$ORG

בדוגמה הבאה אפשר לראות את התגובה לארגון my-org: 

Using Apigee organization `myorg`
 - hello-world
 - weather-app

מידע נוסף

למידע נוסף: