כלי gsutil

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

  • יצירה ומחיקה של קטגוריות.
  • העלאה, הורדה ומחיקה של אובייקטים.
  • הצגת קטגוריות ואובייקטים.
  • העברה, העתקה ושינוי שם של אובייקטים.
  • עריכת רשימות ACL של אובייקטים ושל קטגוריות.

הכלי gsutil מבצע את כל הפעולות, כולל העלאות והורדות, באמצעות HTTPS ו-Transport Layer Security (TLS).

האם להשתמש ב-gsutil?

באופן כללי, צריך להשתמש בפקודות gcloud storage במקום בפקודות gsutil:

  • הכלי gsutil הוא CLI מדור קודם של Cloud Storage, והתחזוקה שלו מינימלית.

  • הכלי gsutil לא תומך בעבודה עם תכונות חדשות יותר של Cloud Storage, כמו מחיקה עם יכולת שחזור ותיקיות מנוהלות.

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

מעבר ל-CLI של gcloud

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

gsutil version -l

  • אם התוצאה של הפקודה כוללת את הערך using cloud sdk: False, סימן שאתם משתמשים בגרסה עצמאית של gsutil. כדי לעבור ל-CLI של gcloud, צריך קודם להתקין את ה-CLI של gcloud.

  • אם התוצאה של הפקודה כוללת את using cloud sdk: True, סימן שה-CLI של gcloud כבר מותקן.

אחרי שמתקינים את ה-CLI של gcloud, אפשר להשתמש בפקודות gcloud storage בדיוק כמו בפקודות gsutil. מקורות המידע הבאים יעזרו לכם להתחיל:

תחביר לגישה למשאבים

הכלי gsutil משתמש בתוספת לשם של מאפיין gs:// כדי לציין משאב ב-Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

בנוסף לציון המשאבים המדויקים, gsutil תומך בשימוש בתווים כלליים לחיפוש בפקודות.

גישה לרשימת קבצים

לפעולות שכוללות מספר גדול של קבצים, אפשר להעביר רשימה של קובצי מקור ל-gsutil באמצעות הדגל -I. הפקודה הזו אומרת ל-gsutil לקרוא את רשימת הקבצים או כתובות ה-URL של האובייקטים מ-stdin ולא מהארגומנטים של שורת הפקודה.

הקלט צריך להיות רשימה של נתיבי קבצים מקומיים או כתובות URL של אובייקטים ב-Cloud Storage, עם נתיב אחד בכל שורה. לדוגמה, אפשר ליצור קובץ בשם example_file_list.txt שמכיל את הנתיבים הבאים:

gs://example-source-bucket/data-01.csv
gs://example-source-bucket/images/logo.png
/local/logs/error_log_20251226.txt

פקודות הדוגמה הבאות קוראות את נתיבי הקבצים מ-example_file_list.txt ומעתיקות אותם לקטגוריית יעד בשם gs://example-destination-bucket:

cat example_file_list.txt | gsutil -m cp -I gs://example-destination-bucket/

אפשר גם ליצור את רשימת הנתיבים תוך כדי תנועה ולהעביר אותה ישירות ל-gsutil. לדוגמה, הפקודות הבאות מעלות את כל קובצי ה-JPG שנמצאים בספרייה הנוכחית ומעתיקות אותם אל gs://example-destination-bucket:

find . -name "*.jpg" | gsutil -m cp -I gs://example-destination-bucket

עזרה מובנית

הכלי gsutil כולל עזרה מובנית יסודית לגבי כל פקודה וגם מספר נושאים, שאותם אפשר להציג ולקרוא באמצעות הפקודה gsutil help.

כדי לקבל מידע על פקודה או נושא ספציפיים, משתמשים בפקודה gsutil help ואחריה בשם הפקודה או הנושא הרצויים. לדוגמה, gsutil help cp ו-gsutil help options הם דף עזרה לפקודות ודף עזרה לנושא, בהתאמה.

כדי לקבל מידע על התקנת ה-gsutil, משתמשים בפקודה gsutil version:

gsutil version -l

סטטיסטיקות שימוש

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

מידע על gsutil

gsutil הוא פרויקט קוד פתוח. כדי להוריד את גרסת הפיתוח של gsutil או להתנדב לעזור בפיתוח gsutil, אפשר להיכנס אל פרויקט gsutil ב-GitHub.

מגבלות

  • כשמשתמשים ב-gsutil עם Windows, אי אפשר לבטל פקודות שמשתמשות בדגל הגלובלי -m באמצעות Ctrl-C.

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