מעבר מ-gcutil ל-gcloud compute

עם הזמינות לכלל המשתמשים של gcloud compute, ב-Compute Engine מומלץ שכל המשתמשים יעברו לשימוש בכלי gcloud compute במקום ב-gcutil. ‫gcloud compute הוא כלי שורת פקודה מאוחד, שכולל מספר שיפורים בהשוואה ל-gcutil, כולל:

  • השלמה אוטומטית באמצעות Tab
  • שדרוג במקום
  • עזרה מקיפה בסגנון דפי man
  • בחירה בין פורמטים שונים של פלט

כדי לעזור למשתמשים לעבור מ-gcutil ל-gcloud compute, במדריך הזה מתואר בקצרה את השינויים העיקריים בין שני הכלים. תיאור מפורט של הכלי gcloud compute זמין במאמרי העזרה בנושא gcloud compute.

פקודות חדשות ב-gcloud

לכל הפקודות הקיימות של gcutil יש פקודות מקבילות בכלי gcloud compute, למעט כמה יוצאים מן הכלל. כדי לראות את הרשימה המלאה של הפקודות של gcloud, אפשר לעבור אל דפי העזרה או להריץ את הפקודה gcloud compute --help. בטבלה הבאה מפורטים בקצרה השינויים בפקודות הפופולריות של gcutil.

פקודת gcutil פקודת gcloud compute 
gcutil addinstance INSTANCE
 
gcloud compute instances create INSTANCE
הערות

יוצר מופע.

  • אפשר להגדיר אזור או תחום (zone) כברירת מחדל, אחרת הפקודה `gcloud compute` תבקש אזור או תחום.
  • יצירת מכונות וירטואליות עם מאפייני ברירת מחדל, כמו:
    • machine-type: n1-standard-1
    • image: debian-10

איך יוצרים מכונה ומפעילים אותה

פקודת gcutil פקודת gcloud compute 
gcutil deleteinstance INSTANCE
 
gcloud compute instances delete INSTANCE \
       [--keep-disks {boot,all,none}]
הערות

מחיקת מכונות. כך מוחקים מכונה.
פקודת gcutil פקודת gcloud compute 
gcutil ... --cache_flag_values
 
gcloud configs set project PROJECT
gcloud configs set compute/zone ZONE
gcloud configs set compute/region REGION
הערות

הגדרת ערכי ברירת מחדל לפרויקט, לאזור ולתחום. הגדרת אזור ואזור ברירת מחדל
פקודת gcutil פקודת gcloud compute 
gcutil push/pull
 
gcloud compute scp
הערות

העתקת קבצים בין מחשב מקומי למכונה וירטואלית. העברת קבצים באמצעות Google Cloud CLI
פקודת gcutil פקודת gcloud compute 
gcutil deleteRESOURCE
 
gcloud compute RESOURCES delete
הערות

מחיקת משאבים, לדוגמה: 

gcloud compute instances delete example-instance
פקודת gcutil פקודת gcloud compute 
gcutil getRESOURCES
 
gcloud compute RESOURCES describe
הערות

תיאור של משאב יחיד, לדוגמה: 

gcloud compute instances describe example-instance
פקודת gcutil פקודת gcloud compute 
gcutil listRESOURCES
 
gcloud compute RESOURCES list
הערות

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

gcloud compute instances list
פקודת gcutil פקודת gcloud compute 
gcutil setmetadata
 
gcloud compute instances add-metadata
gcloud compute instances remove-metadata
gcloud compute project-info add-metadata
gcloud compute project-info remove-metadata
הערות

הכלי מבצע עכשיו נעילה אופטימית, כך שאין צורך לציין טביעת אצבע באופן ידני. הגדרת מטא-נתונים מותאמים אישית של מופע
פקודת gcutil פקודת gcloud compute 
gcutil … --dump_request_response

עדיין לא זמין
פקודת gcutil פקודת gcloud compute 
gcutil … --log_level=DEBUG
 
gcloud … --verbosity debug
הערות

בנוסף, היומנים מאוחסנים בקבצים לכל פקודה ב-‎~/.config/gcloud/logs.
פקודת gcutil פקודת gcloud compute 
gcutil ssh INSTANCE --ssh_user
 
gcloud compute ssh USER@INSTANCE
הערות

איך מתחברים למופע
פקודת gcutil פקודת gcloud compute 
gcutil … \
--image=projects/project-id/global/images/image

gcloud compute … --image image-name \
       --image-project image-project
הערות

איך מפעילים מכונה מתוך תמונה
פקודת gcutil פקודת gcloud compute 
gcutil deleteinstances --[no]delete_pd
gcutil deleteinstances --[no]delete_boot_pd

gcloud compute instances delete … \
       --delete-disks {all,none,boot}
gcloud compute instances delete … \
       --keep-disks {all,none,boot}
הערות

אם דיסק מסומן למחיקה אוטומטית, הוא יימחק אוטומטית אלא אם מציינים זאת באמצעות הדגל --keep-disks.

הגדרות ברירת מחדל של מופע

כשיוצרים מכונה וירטואלית ב-gcloud compute, מוצגים עכשיו כמה ערכי ברירת מחדל לתמונה ולסוג המכונה. כדי להשתמש בערכי ברירת המחדל האלה, לא צריך לציין את הדגלים --image ו---machine-type. כדי לשנות את ההגדרות, צריך לציין את הדגלים המתאימים. הגדרות ברירת המחדל של המכונה הווירטואלית הן:

  • תמונת ברירת מחדל: התמונה העדכנית ביותר של debian-10
  • סוג מכונה שמוגדר כברירת מחדל: n1-standard-1

לדוגמה, אפשר פשוט להריץ את הפקודה:

gcloud compute instances create example-instance --zone us-central1-a

‫gcloud compute תיצור את המופע באמצעות התמונה וסוג המכונה שמתוארים למעלה.

עיצוב הפלט

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

gcloud compute instances list --format {json,yaml,text}

עדכון המטא-נתונים הוא עכשיו תוספתי

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

gcloud compute instances add-metadata example-instance \
         --metadata cookies=chocolate

ציון פרויקטים של תמונות

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

gcutil addinstance example-instance \
         --image=projects/debian-cloud/global/images/debian-9

ב-gcloud compute, צריך עכשיו לציין את פרויקט התמונה באמצעות הדגל החדש --image-project:

gcloud compute instances create example-instance \
         --image debian-9-stretch-vYYYMMDD
         --image-project debian-cloud

אפשר גם לספק את ה-URI המלא:

gcloud compute instances create example-instance \
         --image https://compute.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-9-stretch-vYYYMMDD