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-central-1a, לנהל את הגדרות הרשת באזור asia-east-1 וכו').

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

gcloud config configurations activate CONFIGURATION_NAME

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

מה השלב הבא?