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

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

מהו ה-CLI של gcloud?

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

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

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

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

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

הגרסה הנוכחית של ה-CLI של gcloud היא 574.0.0.

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

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

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

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

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

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

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

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

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

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

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

לדוגמה:

קבוצה של פקודות תיאור
gcloud compute פקודות שקשורות ל-Compute Engine ברמת הזמינות לכלל המשתמשים (GA)
gcloud compute instances פקודות שקשורות למכונות של Compute Engine ברמת הזמינות לכלל המשתמשים (GA)
gcloud beta compute פקודות שקשורות ל-Compute Engine ברמת בטא
gcloud preview פקודות שקשורות ל- Cloud de Confiance בגרסת Preview
gcloud alpha app פקודות שקשורות לניהול פריסה ב-App Engine ברמת אלפא

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

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

תכונות

התכונות של ה-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 (וגם -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.

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