סקירה כללית על ה-CLI של gcloud

דף זה כולל סקירה כללית על Google Cloud CLI ועל דפוסי הפקודות והיכולות הנפוצות שלו.

מהו ה-CLI של gcloud?

Google Cloud CLI הוא קבוצת כלים ליצירה ולניהול של משאבי Google Cloud. משתמשים בהם כדי לבצע משימות נפוצות רבות בפלטפורמה משורת הפקודה או דרך סקריפטים ופעולות אוטומטיות אחרות.

לדוגמה, משתמשים ב-CLI של gcloud כדי ליצור ולנהל את הדברים הבאים:

  • מכונות וירטואליות ומשאבים אחרים של Compute Engine
  • מכונות של Cloud SQL
  • אשכולות של Google Kubernetes Engine
  • אשכולות ומשימות של Dataproc
  • תחומים מנוהלים וקבוצות של רשומות של Cloud DNS
  • פריסות של Cloud Deployment Manager

משתמשים ב-CLI של gcloud גם לפריסה של אפליקציות App Engine, לניהול אימות, להתאמה אישית של הגדרות מקומיות ולביצוע משימות נוספות.

תקציר בנושא ה-CLI של gcloud

כדי לקרוא מבוא קצר על ה-CLI של gcloud, לראות רשימה של פקודות נפוצות ולהבין את המבנה של הפקודות, עיינו במאמר תקציר בנושא ה-CLI של gcloud.

הורדה והתקנה של ה-CLI של gcloud

כאשר משתמשים ב-Cloud Shell, ה-CLI של gcloud זמין אוטומטית ואין צורך להתקינו. במקרים אחרים, מורידים ומתקינים את ה-CLI של gcloud ולאחר מכן מאתחילם אותו.

כברירת מחדל, ה-CLI של gcloud מתקין את הפקודות שברמת הזמינות לכלל המשתמשים (GA). פונקציות נוספות אפשר למצוא ברכיבי ה-CLI של gcloud שנקראים alpha ו-beta. רכיבים אלו מאפשרים להשתמש ב-CLI של gcloud לעבודה עם Cloud Bigtable, ‏Dataflow וחלקים אחרים של Google Cloud בגרסאות של שלבים מוקדמים יותר מאשר רמת הזמינות לכלל המשתמשים (GA).

הגרסה הנוכחית של ה-CLI של gcloud היא 441.0.0. אפשר להוריד ולהתקין גרסאות קודמות של ה-CLI של gcloud מארכיון ההורדות.

רמות של גרסאות

אלו הן רמות הגרסאות של ה-CLI של gcloud:

רמת הגרסה תווית תיאור
זמינות לכלל המשתמשים (GA) אין הפקודות נחשבות יציבות לגמרי ומוכנות לשימוש בשלב הייצור. בנתוני הגרסה אפשר למצוא הודעות מראש לגבי שינויים בפקודות שהפונקציות הנוכחיות שלהן אינן פועלות כראוי.
בטא beta הפקודות מושלמות מבחינה פונקציונלית, אבל יכול להיות שעדיין יש בהן בעיות חריגות. בפקודות אלו ייתכנו שינויים בתפקוד בלי שתתפרסם על כך הודעה.
אלפא alpha ברמה זו יש גרסאות מוקדמות של הפקודות וייתכנו בהן שינויים ללא פרסום הודעה.

הרכיבים alpha ו-beta לא מותקנים כברירת מחדל כאשר מתקינים את ה-CLI של gcloud. צריך להתקין את הרכיבים האלה בנפרד באמצעות הפקודה gcloud components install. כאשר מנסים להריץ פקודות ברמת אלפא או בטא שהרכיב המתאים שלהן לא מותקן, ה-CLI של gcloud יציג הנחיה להתקין אותו.

קבוצות של פקודות

בכל רמת גרסה, הפקודות של ה-CLI של gcloud מסודרות בקבוצות של פקודות בהיררכיה של רכיב בתוך רכיב, שכל אחת מהן מייצגת מוצר או תכונה של Google Cloud או של קבוצות המשנה הפוקציונליות שלו.

לדוגמה:

קבוצה של פקודות תיאור
gcloud compute פקודות שקשורות ל-Compute Engine ברמת זמינות לכלל המשתמשים
gcloud compute instances פקודות שקשורות למכונה של Compute Engine ברמת זמינות לכלל המשתמשים
gcloud beta compute פקודות שקשורות ל-Compute Engine ברמת בטא
gcloud alpha app פקודות שקשורות לניהול פריסה ב-App Engine ברמת אלפא

הרצת הפקודות ב-CLI של gcloud

מריצים את הפקודות של ה-CLI של gcloud משורת הפקודה או מסקריפטים ומפעולות אוטומטיות אחרות. לדוגמה, כאשר משתמשים ב-Jenkins לאוטומציה של משימות ב-Google Cloud.

תכונות

התכונות של ה-CLI של gcloud הן הגדרות שמשפיעות על ההתנהגות של כלי ה-CLI של gcloud. חלק מהתכונות האלו אפשר להגדיר באמצעות אפשרויות או פקודות כלליות, ובמקרה כזה הערך שנקבע על ידי האפשרות מקבל עדיפות.

הפעלת תכונות נגישות

ה-CLI של gcloud כבר כולל את התכונה accessibility/screen_reader, שמאפשרת לשפר את חווית השימוש עם קורא מסך.

כדי לפעיל את תכונת הנגישות, מריצים את:

gcloud config set accessibility/screen_reader true

לקבלת פרטים נוספים על תכונות הנגישות שכבר קיימות בכלי שורת הפקודה של Google Cloud, קראו את המדריך הפעלת תכונות נגישות.

הגדרות אישית

מערך הגדרות אישית הוא קבוצה של תכונות של ה-CLI של gcloud. מערך ההגדרות האישית פועל כמו פרופיל.

כאשר מתחילים להשתמש ב-CLI של gcloud, עובדים עם מערך הגדרות אחד שנקרא default ואפשר להגדיר תכונות על ידי הרצת gcloud init או gcloud config set. מערך הגדרות ברירת המחדל היחיד הזה מתאים למרבית התרחישים לדוגמה.

כדי לעבוד עם כמה פרויקטים או חשבונות להרשאות, מגדירים מערכים שונים של הגדרות עם gcloud config configurations create ועוברים בין המערכים. בתוך מערך הגדרות מסוים אפשר להתאים אישית את התכונות. לדוגמה, כדי להגדיר פרויקט בתוך מערך פעיל של הגדרות אישיות, משתמשים בנכס project:

gcloud config set project <project-id>

לתיאור מפורט של מושגים אלו קראו את המדריך בנושא הגדרות אישיות.

אפשרויות כלליות

ה-CLI של gcloud מספק קבוצה של אפשרויות ב-CLI של gcloud שמנהלות את ההתנהגות של פקודות ברמת ההפעלה הבודדת. האפשרויות מבטלות ומחליפות את הערכים שנקבעו בתכונות של ה-CLI של gcloud.

ארגומנטים ואפשרויות תלויי מיקום

ארגומנטים ואפשרויות תלויי מיקום משפיעים על הפלט של פקודות ב-CLI של gcloud אבל יש הבדל קטן בתרחישי השימוש שלהם. ארגומנט תלוי מיקום משמש להגדרת ישות שעליה פקודה מתבצעת, אבל האפשרות נדרשת לקביעת שינויים בהתנהגות של הפקודה.

השימוש ב-stdout וב-stderr

הפלט של פקודה שבוצעה בהצלחה ב-CLI של gcloud נכתב אל stdout. כל סוגי התשובות האחרים כמו הנחיות, אזהרות ושגיאות נכתבים אל stderr. אסור להוסיף סקריפט המסתמך על התשובות שנכתבות אל stderr כי התשובות האלו אינן יציבות.

הנחיות לטיפול בפלט אפשר למצוא במדריך לכתיבת סקריפט.

הנחיות

כדי להגן מפני פעולות מזיקות שלא במתכוון, ה-CLI של gcloud מבקש מהמשתמשים לאשר את כוונתם לפני ביצוע פקודות כמו gcloud projects delete.

לפעמים מופיעות הנחיות כאשר יש צורך במידע נוסף. לדוגמה, כאשר יוצרים מכונה וירטואלית של Compute Engine באמצעות gcloud compute instances create test-instance, מופיעה בקשה לבחור תחום.

כדי להשבית את ההנחיות, משתמשים באפשרות --quiet.

אסור לכתוב סקריפט שמסתמך על הניסוח של הנחיות כי הניסוח עשוי להשתנות.

עקיפת הנחיות, כתיבה לטרמינל ורישום ביומנים

האפשרות --quiet option (וגם -q) של ה-CLI של gcloud משביתה את ההנחיות האינטראקטיביות כאשר מריצים פקודות ב-CLI של gcloud, והיא שימושית לכתיבת סקריפטים. כאשר צריך קלט, משתמשים בברירת המחדל. אם אין ברירת מחדל, נוצרת שגיאה.

כדי למנוע את הדפסת פלט הפקודה לפלט רגיל ולשגיאה רגילה בטרמינל, משתמשים באפשרות --no-user-output-enabled.

את דרגת המלל של יומני רישום מתאימים באמצעות ציון דרגת המלל (debug‏, info‏, warning‏,error‏, critical או none) בעזרת האפשרות --verbosity.

קביעת מבנה הפלט

כברירת מחדל, כאשר פקודה ב-CLI של gcloud מחזירה רשימה של משאבים, המשאבים יוצאים לקלט סטנדרטי בהדפסה יפה. כדי ליצור פלט משמעותי יותר, האפשרויות format, filter, ו-projection עוזרות לדייק את הפלט.

כדי להגדיר רק את הפורמט של הפלט, משתמשים באפשרות --format כדי ליצור גרסת טבלה או גרסה לא הירארכית של הפלט (לתצוגה אינטראקטיבית) או גרסה של הקלט המיועדת לקריאה בידי מכונה (json, csv, yaml, value).

כדי ליצור רשימת מפתחות שבוחרים ערכים של נתוני משאבים, משתמשים ב-projections. כדי להתאים עוד יותר את הפלט לקריטריונים שמוגדרים על ידיכם, משתמשים ב-filter.

כדי להבין טוב יותר את אופן השימוש בפונקציות הסינון והעיצוב, תוכלו להשתתף במדריך אינטראקטיבי קצר שיפתח בלחיצה על פתיחה ב-Cloud Shell.

Cloud Shell-פתיחה ב

המאמרים הבאים