gcloud compute

בעזרת Google Cloud CLI אפשר לנהל את המשאבים של Compute Engine באמצעות קבוצת הפקודות gcloud compute. ‫gcloud compute היא חלופה לשימוש ב-Compute Engine API.

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

אם זו הפעם הראשונה שאתם משתמשים ב-Compute Engine, כדאי להתחיל עם המדריך למתחילים של Linux או עם המדריך למתחילים של Windows.

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

  • אם רוצים להריץ את gcloud compute בשורת פקודה, צריך להתקין, לעדכן ולהפעיל את Google Cloud CLI.
  • אם אין לכם שורת פקודה זמינה, נסו להשתמש ב-gcloud compute ב-Cloud Shell. ‫Cloud Shell מותקן, מעודכן ומאותחל באופן אוטומטי עם הגרסה האחרונה של Google Cloud CLI.

מאפייני ברירת מחדל

כשיוצרים מכונה וירטואלית, ‏ Compute Engine מגדיר מכונה וירטואלית באמצעות מאפייני ברירת מחדל משרת המטא-נתונים. כדי לבדוק את מאפייני ברירת המחדל של מכונת ה-VM, מריצים את הפקודה הבאה:

gcloud compute project-info describe --project PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט.

פרויקט ברירת המחדל

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

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

  • מריצים כל פקודה gcloud compute עם הדגל --project.

  • הגדרת משתנה הסביבה CLOUDSDK_CORE_PROJECT

    ‫Linux ו-macOS

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

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שרוצים להגדיר כברירת מחדל.

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

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

    unset CLOUDSDK_CORE_PROJECT

    Windows

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

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שרוצים להגדיר כברירת מחדל.

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

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

    set CLOUDSDK_CORE_PROJECT=

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

אזור ותחום שמוגדרים כברירת מחדל

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

יש שלוש דרכים להגדיר את האזור ואת האזור הזמין כברירת מחדל:

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

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

הצגת האזור והתחום שמוגדרים כברירת מחדל

כדי לראות את אזור ברירת המחדל ואת האזור, מריצים את הפקודות הבאות:

gcloud config get-value compute/region
 
gcloud config get-value compute/zone

אם הפלט הוא (unset), לא מוגדר אזור או אזור זמן כברירת מחדל.

הצגת אזורים ותחומים (zones) זמינים

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

gcloud compute regions list
 
gcloud compute zones list

הגדרת אזור וסיווג ברירת מחדל בשרת המטא-נתונים

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

  1. הגדרת האזור והתחום שמוגדרים כברירת מחדל:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE

    לדוגמה:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

  2. מפעילים את השינוי בלקוח המקומי:

    gcloud init

אפשר לשנות את אזור ברירת המחדל ואת האזור שהוגדרו בשרת המטא-נתונים על ידי הגדרת אזור ברירת המחדל והאזור בלקוח המקומי, הגדרת אזור ברירת המחדל והאזור במשתני הסביבה או הוספת הדגל --zone או --region לפקודות.

ביטול ההגדרה של אזור ואזור משנה שמוגדרים כברירת מחדל בשרת המטא-נתונים

כדי לבטל את ההגדרה של אזור ואזור ברירת המחדל בשרת המטא-נתונים:

  1. ביטול ההגדרה של מטא-נתונים:

    gcloud compute project-info remove-metadata \
   --keys=google-compute-default-region,google-compute-default-zone

  2. מפעילים את השינוי בלקוח המקומי:

    gcloud init

הגדרת אזור ותחום ברירת מחדל בלקוח המקומי

האזור ואזור הזמן שמוגדרים כברירת מחדל בלקוח המקומי שלכם מבטלים את האזור ואזור הזמן שמוגדרים כברירת מחדל בשרת המטא-נתונים.

כדי להגדיר את אזור ברירת המחדל ואת האזור בלקוח המקומי, מריצים את הפקודות הבאות:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

ביטול ההגדרה של אזור ותחום ברירת מחדל בלקוח המקומי

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

gcloud config unset compute/zone

gcloud config unset compute/region

אפשר לשנות את אזור ברירת המחדל ואת האזור שהוגדרו בלקוח המקומי באמצעות הגדרת אזור ברירת המחדל והאזור במשתני סביבה, או באמצעות הוספת הדגל --zone או --region לפקודות.

הגדרת אזור ואזור משנה כברירת מחדל במשתני סביבה

אזור ברירת המחדל והאזור שמוגדרים במשתני הסביבה מבטלים את אזור ברירת המחדל והאזור שמוגדרים בלקוח המקומי ובשרת המטא-נתונים.

‫Linux ו-macOS

משתמשים בפקודה export כדי להגדיר את משתני האזור והאזור.

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

כדי להפוך את משתני הסביבה האלה לקבועים, צריך לכלול את הפקודות האלה בקובץ ~/.bashrc ולהפעיל מחדש את הטרמינל.

Windows

משתמשים בפקודה set כדי להגדיר את משתני האזור והאזור.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

אפשר לשנות את משתני הסביבה באמצעות הדגל --zone או --region בפקודות.

ביטול ההגדרה של אזור ותחום ברירת המחדל במשתני הסביבה

משתמשים בפקודות הבאות כדי לבטל את ההגדרה של אזור ברירת המחדל והאזור במשתני הסביבה.

‫Linux ו-macOS

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

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

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

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

שינוי אזור ברירת המחדל באמצעות דגלים

משתמשים בדגל --zone כדי לשנות את אזור ברירת המחדל שמוגדר בשרת המטא-נתונים, בלקוח המקומי ובמשתני הסביבה.

לדוגמה:

gcloud compute instances create example-instance \
    --zone=ZONE

הגדרות אישיות

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

ההגדרות יכולות להיות שימושיות למשתמשים ש:

  • עבודה עם כמה פרויקטים. אפשר ליצור הגדרה נפרדת לכל פרויקט.
  • שימוש בכמה חשבונות. לדוגמה, חשבון משתמש וחשבון שירות.
  • לבצע מגוון משימות עצמאיות (לעבוד על אפליקציית App Engine בפרויקט אחד, לנהל אשכול Compute Engine באזור us-central1-a, לנהל את הגדרות הרשת באזור asia-east1 וכו').

כדי לעבור בין תצורות, מריצים את הפקודה הבאה:

gcloud config configurations activate CONFIGURATION_NAME

מידע נוסף על ניהול הגדרות זמין במאמר בנושא gcloud config configurations.

מה השלב הבא?