פקודות נפוצות של gcloud compute

במסמך הזה מפורטות כמה מהפקודות הנפוצות ביותר של gcloud compute.

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:
    1. התקינו את ה-CLI של Google Cloud. אחר כך, מאתחלים את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

      gcloud init

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

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

תיאור פרויקטים

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

 gcloud compute project-info describe

מידע נוסף על תיאור הפרויקט זמין במאמרי העזרה בנושא gcloud compute project-info describe.

עבודה עם מכונות וירטואליות

בדוגמאות הבאות מוצגות משימות נפוצות בעבודה עם מכונות וירטואליות (VM). מידע נוסף על מכונות וירטואליות (VM) זמין במאמר מכונות וירטואליות.

יצירת מכונות וירטואליות

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

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

מחליפים את מה שכתוב בשדות הבאים:

  • ‫VM_NAME: השם של המכונה הווירטואלית החדשה.
  • ‫IMAGE או IMAGE_FAMILY: מציינים אחת מהאפשרויות הבאות:
    • ‫IMAGE: הגרסה הנדרשת של תמונה ציבורית. לדוגמה, --image debian-10-buster-v20200309.
    • ‫IMAGE_FAMILY: משפחת תמונות. כך נוצרת מכונה וירטואלית מקובץ אימג' של מערכת ההפעלה העדכני ביותר שלא הוצא משימוש. לדוגמה, אם מציינים --image-family debian-10, ‏ Compute Engine יוצר מכונה וירטואלית מהגרסה העדכנית של קובץ אימג' של מערכת ההפעלה במשפחת התמונות Debian 10.
  • ‫IMAGE_PROJECT: הפרויקט שמכיל את התמונה.

מידע נוסף על יצירת מכונות וירטואליות זמין במאמרים יצירה והפעלה של מכונה וירטואלית ובמסמכי העזרה בנושא gcloud compute instances create.

הצגת רשימה של מכונות וירטואליות

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

gcloud compute instances list

מידע נוסף על הצגת רשימה של מכונות וירטואליות זמין במאמרי העזרה בנושא gcloud compute instances list.

הצגת רשימה של מכונות וירטואליות עם יחידות GPU

מריצים את הפקודה הבאה כדי להציג את כל המכונות הווירטואליות עם GPUs בפרויקט:

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

הצגת רשימה של מכונות וירטואליות עם כונני SSD מקומיים

מריצים את הפקודה הבאה כדי להציג את כל המכונות הווירטואליות עם כונני SSD מקומיים בפרויקט:

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

תיאור של מכונות וירטואליות

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

gcloud compute instances describe VM_NAME

מחליפים את VM_NAME בשם המכונה הווירטואלית.

מידע נוסף על תיאור מכונות וירטואליות מופיע במאמרי העזרה בנושא gcloud compute instances describe.

הפעלת מכונות וירטואליות

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

gcloud compute instances start VM_NAME

מחליפים את VM_NAME בשם המכונה הווירטואלית.

מידע נוסף על הפעלת מכונות וירטואליות זמין במאמר הפעלה ועצירה של מכונה ובמאמרי העזרה של gcloud compute instances start.

הפסקת מכונות וירטואליות

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

gcloud compute instances stop VM_NAME

מחליפים את VM_NAME בשם המכונה הווירטואלית.

מידע נוסף על עצירת מכונות וירטואליות זמין במאמר הפעלה ועצירה של מכונה ובמאמרי העזרה של gcloud compute instances stop.

הוספת תוויות למכונות וירטואליות

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

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

מחליפים את מה שכתוב בשדות הבאים:

  • ‫VM_NAME: שם ה-VM.
  • ‫KEY=VALUE: צמד מפתח/ערך של התווית.

מידע נוסף על תיוג מכונות וירטואליות זמין במאמרים תיוג משאבים ובמאמרי העזרה של gcloud compute instances add-labels.

התחברות למכונות וירטואליות

שימוש ב-SSH כדי להתחבר למכונות

מריצים את הפקודה הבאה כדי להתחבר למכונה וירטואלית באמצעות SSH:

gcloud compute ssh VM_NAME

מחליפים את VM_NAME בשם המכונה הווירטואלית.

מידע נוסף על התחברות למכונות וירטואליות באמצעות SSH זמין במאמר התחברות למכונות וירטואליות של Linux ובמאמרי העזרה של gcloud compute ssh.

שימוש ב-SCP להעברת קבצים למופעים

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

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

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

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

מחליפים את מה שכתוב בשדות הבאים:

  • ‫LOCAL_FILE_PATH: הנתיב לקובץ בתחנת העבודה.
  • ‫VM_NAME: השם של המכונה הווירטואלית.
  • ‫REMOTE_DIRECTORY: הנתיב לספרייה במכונה הווירטואלית.

מידע נוסף על העברת קבצים אל מכונות וירטואליות וממכונות וירטואליות באמצעות SCP זמין במאמר העברת קבצים באמצעות Google Cloud CLI ובמאמרי העזרה בנושא gcloud compute scp.

עבודה עם דיסקים

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

הצגת רשימת הדיסקים

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

gcloud compute disks list

למידע נוסף על הצגת רשימת דיסקים, עיינו במאמרי העזרה של gcloud compute disks list.

עבודה עם תמונות מצב

בדוגמאות הבאות מוצגות משימות נפוצות כשעובדים עם תמונות מצב. מידע נוסף על תמונות מצב זמין במאמר בנושא תמונות מצב של Persistent Disk.

הצגת רשימה של תמונות מצב

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

gcloud compute snapshots list

מידע נוסף על תיאור תמונות מצב מופיע במאמרי העזרה של gcloud compute snapshots list.

תיאור תמונות מצב

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

gcloud compute snapshots describe SNAPSHOT_NAME

מחליפים את SNAPSHOT_NAME בשם של התמונה.

מידע נוסף על תיאור תמונות מצב מופיע במאמרי העזרה של gcloud compute snapshots describe.

מחיקת תמונות מצב

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

gcloud compute snapshots delete SNAPSHOT_NAME

מחליפים את SNAPSHOT_NAME בשם של התמונה.

למידע נוסף על מחיקת קובצי snapshot, קראו את המאמר מחיקת קובץ snapshot ואת מאמרי העזרה של gcloud compute snapshots delete.

עבודה עם כללים לחומת אש

בדוגמאות הבאות מוצגות משימות נפוצות כשעובדים עם כללים של חומת אש. מידע נוסף על הכללים של חומת האש ב-VPC

תיאור של כללי חומת אש

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

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

מחליפים את FIREWALL_RULE_NAME בשם של כלל חומת האש.

מידע נוסף על תיאור כללים של חומת אש מופיע בgcloud compute firewall-rules describeמאמרי העזרה.

יצירת כללים של חומת אש

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

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

מציינים את --allow או את --action ו---rules, ומחליפים את הערכים הבאים:

  • ‫FIREWALL_RULE_NAME: השם של כלל חומת האש.
  • ‫ACTION: הפעולה במקרה של התאמה. ‫allow או deny.
  • ‫PROTOCOL:PORT: הפרוטוקול והיציאה שהתעבורה שלהם תושפע מכלל חומת האש.

למידע נוסף על יצירת כללים של חומת האש, קראו את המאמר יצירת כללים של חומת אש ואת מאמרי העזרה של gcloud compute firewall-rules create.

עבודה עם קבוצות של מופעי מכונה מנוהלים (MIG)

בדוגמאות הבאות מוצגות משימות נפוצות כשעובדים עם קבוצות של מכונות וירטואליות לניהול מופעים (MIG). מידע נוסף על קבוצות MIG זמין במאמר בנושא קבוצות של מופעי מכונה מנוהלים (MIG).

יצירת קבוצות מופעי מכונה מנוהלים

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

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_URL

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת המכונות
  • ‫SIZE: הגודל של קבוצת המכונות
  • ‫INSTANCE_TEMPLATE_URL: כתובת ה-URL של תבנית של הגדרות מכונה שרוצים להשתמש בה כדי ליצור מכונות ב-MIG. כתובת ה-URL יכולה להכיל את המזהה או את השם של תבנית של הגדרות מכונה. מציינים אחד מהערכים הבאים:
    • לתבנית של הגדרות מכונה אזורית: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • לתבנית גלובלית של הגדרות מכונה: INSTANCE_TEMPLATE_ID

מידע נוסף על יצירת קבוצות MIG זמין במאמר תרחישים בסיסיים ליצירת קבוצת MIG ובמאמרי העזרה של gcloud compute instance-groups managed create.

הגדרת התאמה אוטומטית לעומס

מריצים את הפקודה הבאה כדי להגדיר התאמה אוטומטית לעומס בקבוצת מכונות מנוהלות (MIG), על סמך ניצול המעבד (CPU):

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_GROUP_NAME: השם של קבוצת MIG
  • ‫MAX_NUM_REPLICAS: המספר המקסימלי של רפליקות שהמידרוג האוטומטי יכול ליצור
  • ‫TARGET_CPU_UTILIZATION: רמת המעבד (CPU) שצריך לשמור על קנה המידה האוטומטי, בין 0.0 ל-1.0

מידע נוסף על הגדרת שינוי גודל אוטומטי זמין במאמר בנושא קבוצות של מופעים עם שינוי גודל אוטומטי ובמסמכי העיון בנושא gcloud compute instance-groups managed set-autoscaling.

עבודה עם מטא-נתונים

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

הוספת מטא-נתונים ברמת הפרויקט

מריצים את הפקודה הבאה כדי להוסיף מטא-נתונים לפרויקט:

gcloud compute project-info add-metadata \
    --metadata=KEY=VALUE,[KEY=VALUE]

מחליפים את מה שכתוב בשדות הבאים:

  • ‫KEY=VALUE: צמד המפתח/ערך של המטא-נתונים

מידע נוסף על הוספת מטא-נתונים למכונות וירטואליות זמין במאמר הגדרת מטא-נתונים מותאמים אישית בפרויקט ובמאמרי העזרה של gcloud compute project-info add-metadata.

הוספת מטא-נתונים ברמת המופע

מריצים את הפקודה הבאה כדי להוסיף מטא-נתונים למכונה וירטואלית:

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

מחליפים את מה שכתוב בשדות הבאים:

  • ‫VM_NAME: השם של ה-VM
  • ‫KEY=VALUE: צמד מפתח/ערך של מטא-נתונים

למידע נוסף על הוספת מטא-נתונים למכונות וירטואליות, קראו את המאמר הגדרת מטא-נתונים בהתאמה אישית של מכונות ואת מאמרי העזרה של gcloud compute instances add-metadata.

דפי עזרה

הפקודות הבאות מראות איך לגשת לסוגים שונים של עזרה, מעזרה כללית לגבי הפקודה gcloud compute ועד לעזרה ספציפית לגבי קבוצת משאבים (instances) או פקודה (create). עזרה מקיפה לכל המשאבים והפקודות מוצגת בדפוס הבא:

gcloud compute --help
gcloud compute instances --help
gcloud compute instances create --help

אפשר לקבל עזרה מהירה באמצעות הדגל -h במקום הדגל --help. אפשר גם לעיין בכל העזרה המקיפה במאמרי העזרה של Google Cloud CLI.

כדי לקבל עזרה מקיפה בפקודות שספציפיות להגדרת ה-CLI של gcloud, מריצים את הפקודה:

gcloud topic TOPIC

מחליפים את TOPIC בנושא שלגביו רוצים לקבל עזרה. לרשימה של נושאים שאפשר לקבל בהם עזרה, עיינו במאמרי העזרה של gcloud topic.

מה השלב הבא?

  • במאמר הזה מופיע מידע על פקודות go-to לכמה מוצרים של Google Cloud .