דף זה כולל סקירה כללית על 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.
המאמרים הבאים
- לקבלת מידע נוסף על הפקודות ב-CLI של ה-cloud קראו את מדריך העזר ל-CLI של gcloud.