אחסון אובייקטים באמצעות Google Cloud CLI

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

העלויות של Cloud Storage מבוססות על המשאבים שבהם משתמשים. המדריך למתחילים הזה משתמש בדרך כלל במשאבים של Cloud Storage בשווי של פחות מ-0.01 דולר ארה"ב.

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

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

  2. התקינו את ה-CLI של Google Cloud.

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

  4. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  5. יוצרים או בוחרים פרויקט ב- Google Cloud .

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

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

    • יוצרים פרויקט ב- Google Cloud :

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של הפרויקט ב- Google Cloud שאתם יוצרים.

    • בוחרים את הפרויקט שיצרתם ב- Google Cloud :

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  6. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  7. נותנים תפקידים לחשבון המשתמש. מריצים את הפקודה הבאה לכל אחד מהתפקידים הבאים ב-IAM: roles/storage.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

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

    • ‫PROJECT_ID: מזהה הפרויקט.
    • ‫USER_IDENTIFIER: המזהה של חשבון המשתמש . לדוגמה, myemail@example.com.
    • ‫ROLE: התפקיד ב-IAM שאתם נותנים לחשבון המשתמש.

  8. התקינו את ה-CLI של Google Cloud.

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

  10. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  11. יוצרים או בוחרים פרויקט ב- Google Cloud .

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

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

    • יוצרים פרויקט ב- Google Cloud :

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של הפרויקט ב- Google Cloud שאתם יוצרים.

    • בוחרים את הפרויקט שיצרתם ב- Google Cloud :

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  12. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  13. נותנים תפקידים לחשבון המשתמש. מריצים את הפקודה הבאה לכל אחד מהתפקידים הבאים ב-IAM: roles/storage.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

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

    • ‫PROJECT_ID: מזהה הפרויקט.
    • ‫USER_IDENTIFIER: המזהה של חשבון המשתמש . לדוגמה, myemail@example.com.
    • ‫ROLE: התפקיד ב-IAM שאתם נותנים לחשבון המשתמש.
    14.

יצירת קטגוריה

קטגוריות הן הקונטיינרים הבסיסיים ששומרים את הנתונים שלכם ב-Cloud Storage.

כדי ליצור קטגוריה:

  1. פותחים חלון טרמינל.

  2. משתמשים בפקודה gcloud storage buckets create ובשם ייחודי גלובלי כדי ליצור קטגוריה:

    gcloud storage buckets create gs://BUCKET_NAME/ --uniform-bucket-level-access

    מחליפים את BUCKET_NAME בשם של הקטגוריה.

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

    Creating gs://my-awesome-bucket/...

    אם שם הקטגוריה שבחרתם כבר נמצא בשימוש שלכם או של מישהו אחר, הפקודה מחזירה תשובה כמו ServiceException: 409 Bucket my-awesome-bucket already exists.. אתם צריכים לנסות שוב עם שם קטגוריה אחר.

יצרתם עכשיו קטגוריה שבה תוכלו לאחסן את הנתונים שלכם!

העלאת אובייקט לקטגוריה

  1. שומרים את התמונה הבאה במחשב, למשל בשולחן העבודה.

    חתלתול עם כפות רגליים פרושות.

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

    gcloud storage cp OBJECT_LOCATION gs://BUCKET_NAME

    מחליפים את OBJECT_LOCATION במיקום שבו שמרתם את קובץ האימג', למשל Desktop/kitten.png.

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

    Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
  Completed files 1/1 | 8.6kiB/8.6kiB

    אחסנתם עכשיו אובייקט בקטגוריה.

הורדת האובייקט מהקטגוריה

  1. משתמשים בפקודה gcloud storage cp כדי להוריד את התמונה שאחסנתם בקטגוריה למקום כלשהו במחשב, למשל לשולחן העבודה:

    gcloud storage cp gs://BUCKET_NAME/kitten.png Desktop/kitten2.png

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

    Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
  Completed files 1/1 | 8.6kiB/8.6kiB

    הורדתם עכשיו משהו מהקטגוריה.

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

  1. משתמשים בפקודה gcloud storage cp כדי ליצור תיקייה מדומה ולהעתיק אליה את התמונה:

    gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

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

    Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
  Completed files 1/1 | 8.6kiB/8.6kiB

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

הצגת רשימה של תוכן הקטגוריה

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

    gcloud storage ls gs://BUCKET_NAME

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

    gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/quickstart-folder/

    ראיתם עכשיו את התוכן ברמה העליונה של הקטגוריה.

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

  1. משתמשים בפקודה gcloud storage ls עם הדגל --long כדי לקבל פרטים על אחת מהתמונות:

    gcloud storage ls gs://BUCKET_NAME/kitten.png --long

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

    8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
TOTAL: 1 objects, 8775 bytes (8.57kiB)

    קיבלתם עכשיו מידע על הגודל ותאריך היצירה של התמונה.

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

  1. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי להעניק לכל המשתמשים הרשאה לקרוא את התמונות שמאוחסנות בקטגוריה:

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

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

    bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer

    עכשיו כולם יכולים לקבל את התמונות שלכם.

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

    gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer

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

    הסרתם את הגישה הציבורית לתמונות שבקטגוריה.

מתן גישה לקטגוריה לאדם ספציפי

  1. משתמשים בפקודה gcloud storage buckets add-iam-policy-binding כדי לתת לכתובת אימייל ספציפית הרשאה להוסיף אובייקטים לקטגוריה:

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=user:jeffersonloveshiking@gmail.com --role=roles/storage.objectCreator

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

    bindings:
  - members:
    - user:jeffersonloveshiking@gmail.com
    role: roles/storage.objectCreator

    עכשיו המשתמש הזה יכול להוסיף פריטים לקטגוריה.

  2. כדי להסיר את ההרשאה הזו, משתמשים בפקודה הבאה:

    gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=user:jeffersonloveshiking@gmail.com --role=roles/storage.objectCreator

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

    הסרתם את הרשאת הגישה של המשתמש לקטגוריה.

מחיקת אובייקט

  1. משתמשים בפקודה gcloud storage rm כדי למחוק אחת מהתמונות:

    gcloud storage rm gs://BUCKET_NAME/kitten.png

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

    Removing gs://my-awesome-bucket/kitten.png...

    העותק הזה של התמונה לא מאוחסן יותר ב-Cloud Storage (אבל העותק שיצרתם בתיקייה המדומה quickstart-folder/ עדיין קיים).

הסרת המשאבים

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

  1. משתמשים בפקודה gcloud storage rm עם הדגל --recursive כדי למחוק את הקטגוריה ואת כל מה שבתוכה:

    gcloud storage rm gs://BUCKET_NAME --recursive

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

    Removing objects:
Removing gs://my-awesome-bucket/quickstart-folder/kitten3.png#1768960201129254
  Completed 1/1
Removing buckets:
Removing gs://my-awesome-bucket/...
  Completed 1/1

    הקטגוריה והתוכן שלה נמחקו.

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