התקנת gsutil

‫gsutil הוא כלי שמאפשר לגשת ל-Cloud Storage משורת הפקודה באמצעות HTTPS. בדף הזה מוסבר איך להתקין ולהגדיר את gsutil כחלק מ-Google Cloud CLI.

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

דרישות מערכת

  • אפשר להריץ את הכלי gsutil ב-Linux/Unix, ב-Mac OS וב-Windows (מ-XP ומעלה).

  • בגרסאות gsutil 5.36 ואילך נדרשת Python 3.9 עד 3.14. אפשר להשיג אותה באמצעות מנהל הגרסאות של Python או על ידי התקנת גרסה מתאימה.

ניהול גרסאות Python

בהוראות הבאות מוסבר איך לנהל גרסאות Python:

Linux

דרישות מוקדמות: מתקינים מנהל גרסאות של Python‏ (pyenv) ומתקינים גרסת Python מתאימה.

  1. מגדירים את גרסת Python הגלובלית:
    • כדי להגדיר את Python 3.13 כגרסה הגלובלית: 
      pyenv global 3.13
    • או להגדיר את גרסת Python באופן מקומי לתיקיית פרויקט ספציפית: 
      pyenv local 3.13
  2. מוודאים שמשתמשים בגרסת Python הנכונה: 
    python --version

    הפרטים שמוצגים הם:

    Python 3.13
macOS

שיטה 1: שימוש ב-Homebrew ‏ (brew)

דרישות מוקדמות: צריך להתקין את Homebrew ואת גרסת Python מתאימה דרך Homebrew.

  1. הגדרת גרסה ספציפית של Python כברירת מחדל:
    • מוסיפים את הגרסה הרצויה אל $PATH. לדוגמה, כדי להשתמש ב-Python 3.13: 
      export PATH="/usr/local/opt/python@3.13/bin:$PATH"
    • כדי שהשינוי יהיה קבוע, מוסיפים את הנתיב לקובץ התצורה של המעטפת (~/.bash_profile,‏ ~/.zshrc או ~/.bashrc).
  2. מוודאים שמשתמשים בגרסת Python הנכונה: 
    python --version

    הפרטים שמוצגים הם:

    Python 3.13

שיטה 2: שימוש ב-pyenv

תנאים מוקדמים: מתקינים את מנהל הגרסאות של Python‏ (pyenv) ומתקינים גרסת Python מתאימה באמצעות pyenv.

  1. מגדירים את גרסת Python הגלובלית:
    • כדי להגדיר את גרסת Python באופן גלובלי (לכל הטרמינלים): 
      pyenv global 3.13
    • או להגדיר את גרסת Python באופן מקומי לתיקיית פרויקט ספציפית: 
      pyenv local 3.13
  2. מוודאים שמשתמשים בגרסת Python הנכונה: 
    python --version

    הפרטים שמוצגים הם:

    Python 3.13
Windows

דרישות מוקדמות: מתקינים את מנהל הגרסאות של Python‏ (pyenv-win) ומתקינים גרסת Python מתאימה באמצעות pyenv.

  1. מגדירים את גרסת Python הגלובלית:
    • כדי להגדיר את Python 3.13 כגרסה הגלובלית: 
      pyenv global 3.13
    • או להגדיר את גרסת Python באופן מקומי לתיקיית פרויקט ספציפית: 
      pyenv local 3.13
  2. מוודאים שמשתמשים בגרסת Python הנכונה: 
    python --version

    הפרטים שמוצגים הם:

    Python 3.13
  • אם אתם מתכננים להשתמש באובייקטים מורכבים, עליכם להתקין את crcmod בגרסה שעברה הידור. ב-Windows, האפשרות הזו זמינה רק בגרסת 32 סיביות של Python. מידע נוסף על crcmod אפשר לקבל אחרי התקנת gsutil, במאמר העזרה בנושא, באמצעות הפקודה gsutil help crc32c.

התקנת gsutil

השיטה שנתמכת באופן רשמי של gsutil שאיתה מתקינים ומעדכנים את gsutil היא חלק מ-Google Cloud CLI.

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

התקנת gsutil כחלק מ-Google Cloud CLI

כדי להתקין את gsutil כחלק מ-Google Cloud CLI, צריך לבצע את ההוראות לפי מערכת ההפעלה:

Linux
  1. קודם מוודאים שיש תמיכה בגרסת Python שלכם. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14. חבילת x86_64 של Linux כוללת מתורגמן Python בחבילה, שיקבל עדיפות כברירת מחדל. במאמרי העזרה בנושא gcloud topic startup מוסבר איך בוחרים את רכיב התרגום ב-Python ואיך מגדירים אותו.
  2. מורידים אחת מהחבילות הבאות:
    פלטפורמה שם חבילה גודל סיכום ביקורת (checksum)‏ SHA256
    ‏Linux‏ 64 סיביות

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz ‫88.1MB 3727f6aba95108cffa64448cef5db8b4981d4c48d821b4482dbffbdaef344ed1
    ‏Linux‏ 64 סיביות

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz ‫61.0MB 047768995ce95f525c8e5af805f3697238438b7f48f7b3c5e0a9c3bd0d661810
    ‏Linux‏ 32 סיביות

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz ‫61.1MB 7130c90d3cdc635824c845cb6b65357890558abcfab2caab34272f13a32d24bb

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

    מעיינים בטבלה שלמעלה ומחליפים את google-cloud-cli-linux-x86_64.tar.gz בשם החבילה *.tar.gz שרלוונטי להגדרה שלכם.

  3. כדי לחלץ את התוכן של הקובץ למערכת הקבצים, מריצים את הפקודה הבאה: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     כדי להחליף התקנה קיימת, מוחקים את ספריית google-cloud-sdk הקיימת ומחלצים את קובץ הארכיון לאותו המיקום.
  4. מריצים את סקריפט ההתקנה מהרמה הבסיסית (root) של התיקייה שאליה חילצתם את הקבצים:
    ‫
    ./google-cloud-sdk/install.sh
     הסקריפט יבקש מכם לבצע את פעולות ההגדרה הבאות. כדי לאשר, עונים לשיחה Y כשמופיעה בקשה.
    • מוסיפים את ה-CLI של gcloud ל-PATH.
    • מפעילים את השלמת הפקודות.
    • מאשרים לשלוח נתוני שימוש אנונימיים כדי לעזור לשפר את ה-CLI של gcloud.
    אפשר גם לבצע את ההתקנה באופן לא אינטראקטיבי על ידי ציון דגלים. כדי לראות את הדגלים הזמינים, מריצים את הפקודה: 
    ./google-cloud-sdk/install.sh --help
  5. אופציונלי: אם עדכנתם את PATH בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.
  6. מריצים את הפקודה gcloud init כדי לאתחל, לתת הרשאות ולהגדיר את ה-CLI של gcloud.
  7. אופציונלי: אפשר להתקין עוד רכיבים באמצעות מנהל הרכיבים.
Debian/Ubuntu

תכולת החבילה

ה-CLI של gcloud זמין בפורמט של חבילה להתקנה במערכות Debian ו-Ubuntu. החבילה הזו כוללת רק את כלי שורת הפקודה gcloud,‏ gcloud alpha,‏ gcloud beta,‏ gsutil ו-bq. היא לא כוללת את הפקודה kubectl או את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות פקודות gcloud. את הרכיבים האלו תצטרכו להתקין בנפרד בהתאם לצורך.

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

לפני שמתקינים את ה-CLI של gcloud צריך לוודא שמערכת ההפעלה עומדת בדרישות הבאות:

  • מותקנת גרסת Ubuntu שלא הגיעה לסוף חיי המוצר או גרסה יציבה של Debian שלא הגיעה לסוף חיי המוצר.
  • החבילות שבה התעדכנו לאחרונה. כדי לעשות זאת עכשיו, מריצים את הפקודה הבאה: 
    sudo apt-get update
  • מותקנות בה הפקודות ca-certificates,‏ gnupg ו-curl. כדי להתקין את החבילות האלה, מריצים את הפקודה הבאה: 
    sudo apt-get install ca-certificates gnupg curl

התקנה

  1. מייבאים את Google Cloud המפתח הציבורי.

    • בגרסאות חדשות יותר (Debian 9 ואילך או Ubuntu 18.04 ואילך), מריצים את הפקודה הבאה:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • בגרסאות ישנות יותר של הפצות, מריצים את הפקודה הבאה: 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

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

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • אם אתם לא מצליחים לקבל עדכונים בגלל שתוקף המפתח פג, עליכם לקבל את קובץ המפתח apt-get.gpg העדכני.

  2. מוסיפים את URI ההפצה של ה-CLI של gcloud בתור מקור של חבילה.
    • בגרסאות חדשות יותר (Debian 9 ואילך או Ubuntu 18.04 ואילך), מריצים את הפקודה הבאה: 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

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

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. עדכון והתקנת ה-CLI של gcloud:
    ‫
    sudo apt-get update && sudo apt-get install google-cloud-cli
     תוכלו לקרוא על עוד אפשרויות לפקודה apt-get, כמו השבתת הנחיות או הרצות בדיקה, במדריך המפורט של apt-get.

    טיפ לגבי Docker: כשמתקינים את ה-CLI של gcloud בקובץ אימג' של Docker, אפשר להשתמש בפקודת RUN יחידה:

    ‫
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    לגבי תמונות בסיס ישנות שלא תומכות בפקודה gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. אופציונלי: התקנת רכיבים נוספים:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-tools
    • google-cloud-cli-tests
    • kubectl

    לדוגמה, את הרכיב google-cloud-cli-app-engine-java אפשר להתקין כך: 

    sudo apt-get install google-cloud-cli-app-engine-java
  5. מריצים את הפקודה gcloud init כדי לאתחל, לתת הרשאות ולהגדיר את ה-CLI של gcloud.

שדרוג לאחור של גרסאות ה-CLI של gcloud

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

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

עשר הגרסאות האחרונות תמיד זמינות במאגר. בגרסאות שלפני 371.0.0, שם החבילה הוא google-cloud-sdk

‫
Red Hat/Fedora/CentOS

תכולת החבילה

ה-CLI של gcloud זמין בפורמט של חבילה להתקנה במערכות של Red Hat Enterprise Linux 7,‏ 8,‏ 9 ו-10;‏ Fedora 41 ו-42; ו-CentOS 7 ו-8. החבילה הזו כוללת רק את הפקודות gcloud,‏ gcloud alpha,‏ gcloud beta,‏ gsutil ו-bq. היא לא כוללת את הפקודה kubectl או את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות הפקודות gcloud שאותן אפשר להתקין בנפרד, כמו שמתואר בהמשך.

התקנה

  1. מעדכנים את DNF בפרטי המאגר של ה-CLI של gcloud.

    • הדוגמה הבאה מתייחסת להתקנות שתואמות ל-Red Hat Enterprise Linux 7,‏ 8 או 9, אבל חשוב לעדכן את ההגדרות לפי הצורך בהתאם להגדרה שלכם:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • במערכות תואמות ל-RHEL 10, משתמשים בפקודה הבאה עם gpgkey המעודכן:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM

    • בהתקנות של ARM64 ‏ (aarch64), משתמשים ב-https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (תואם ל-RHEL 7,‏ 8 או 9) או ב-https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (תואם ל-RHEL 10) כערך של baseurl.

  2. מתקינים את libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. מתקינים את ה-CLI של gcloud:
    ‫
    sudo dnf install google-cloud-cli
  4. אופציונלי: התקנת רכיבים נוספים:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    לדוגמה, כדי להתקין את הרכיב google-cloud-cli-app-engine-java, מריצים את הפקודה הבאה: 

    sudo dnf install google-cloud-cli-app-engine-java
  5. מריצים את הפקודה gcloud init כדי לאתחל, לתת הרשאות ולהגדיר את ה-CLI של gcloud.

שדרוג לאחור של גרסאות ה-CLI של gcloud

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

sudo dnf downgrade google-cloud-cli-123.0.0

עשר הגרסאות האחרונות זמינות במאגר. בגרסאות שלפני 371.0.0, שם החבילה הוא google-cloud-sdk.

macOS
  1. קודם מוודאים שיש תמיכה בגרסת Python שלכם. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14.

    כדי לבדוק איזו גרסה של Python מותקנת, מריצים את הפקודה python3 -V או את הפקודה python -V.

    תוכנת ההתקנה של gcloud תתקין כברירת מחדל את Python v3.14 ואת מודולי התוספים הנדרשים.

    מידע נוסף על הגדרת רכיב התרגום של Python מופיע במאמרי העזרה של gcloud topic startup.

  2. מורידים אחת מהחבילות הבאות:
    פלטפורמה חבילה גודל סיכום ביקורת (checksum)‏ SHA256
    macOS‏ 64 סיביות

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz ‫61.2MB 123c47e410a9b274cd8a95f243277e19a32a8153972e425b16cc442d621b46ba
    macOS‏ 64 סיביות

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz ‫61.1MB 502901c8d19c21b23803b33d5cedd417dcb16b12c918f162fb37e08c4be27d92
    macOS ‏32-סיביות

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz ‫59.5MB 20c480e5a0c92128dd67a6304dc143545ab0558054de77fecd1b85d1fcbf66f3

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME
  3. מחלצים את התוכן של הקובץ למיקום הרצוי במערכת הקבצים. נהוג לחלץ אותו לתיקיית הבית.

    ב-macOS, אפשר לעשות את זה על ידי פתיחת הקובץ שהורדתם .tar.gz במיקום הרצוי. לחלופין, משורת הפקודה, מריצים את הפקודה: 

    tar -xf FILE_NAME

    כדי להחליף התקנה קיימת, מסירים את ספריית google-cloud-sdk הקיימת ומחלצים את קובץ הארכיון לאותו המיקום.

  4. מריצים את סקריפט ההתקנה מהרמה הבסיסית (root) של התיקייה שאליה חילצתם את הקבצים:
    ‫
    ./google-cloud-sdk/install.sh
     הסקריפט יבקש מכם לבצע את פעולות ההגדרה הבאות. כדי לאשר, עונים לשיחה Y כשמופיעה בקשה.
    • אם צריך, מתקינים את Python 3.13 ואת המודולים המומלצים.
    • מוסיפים את ה-CLI של gcloud ל-PATH ומפעילים את האפשרות להשלמת פקודות.
    • מאשרים לשלוח נתוני שימוש אנונימיים כדי לעזור לשפר את ה-CLI של gcloud.
    אפשר גם לבצע את ההתקנה באופן לא אינטראקטיבי על ידי ציון דגלים. כדי לראות את הדגלים הזמינים, מריצים את הפקודה: 
    ./google-cloud-sdk/install.sh --help
     כדי להריץ את סקריפט ההתקנה עם מצב קורא המסך מופעל: 
    ./google-cloud-sdk/install.sh --screen-reader=true
  5. אופציונלי: אם עדכנתם את PATH בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.
  6. מריצים את הפקודה gcloud init כדי לאתחל, לתת הרשאות ולהגדיר את ה-CLI של gcloud.
  7. אופציונלי: אפשר להתקין עוד רכיבים באמצעות מנהל הרכיבים.
Windows

כדי להשתמש ב-Google Cloud CLI ב-Windows, צריך Windows בגרסה 8.1 ואילך או Windows Server בגרסה 2012 ואילך.

  1. מורידים את מנהל ההתקנה של Google Cloud CLI.

    לחלופין, פותחים טרמינל ב-PowerShell ומריצים את פקודות PowerShell הבאות: 

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. מפעילים את מנהל ההתקנה וממשיכים בהתאם להנחיות. מנהל ההתקנה חתום על ידי Google LLC.‎.

    • אם אתם משתמשים בקורא מסך, מסמנים את התיבה Turn on screen reader mode. האפשרות הזו מגדירה את התצורה של gcloud לשימוש במכשירי מעקב אחרי סטטוס במקום בסימנים גרפיים שמתבצעת פעולה בשפת Unicode, להצגת ההתקדמות כאחוזים ולהצגת טבלאות כטקסט פשוט ללא היררכיה. לקבלת מידע נוסף, עיינו במדריך תכונות הנגישות.
    • ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14. גרסת Windows של Google Cloud CLI מגיעה כחבילה עם Python 3 כברירת מחדל. כדי להשתמש ב-Google Cloud CLI, מערכת ההפעלה צריכה להיות מסוגלת להריץ גרסה נתמכת של Python.
    • מנהל ההתקנה מתקין את כל הרכיבים התלויים שנדרשים, כולל את גרסת Python המתאימה. ‫Google Cloud CLI מתקין ומנהל את Python 3 כברירת מחדל. אבל במקרה הצורך אפשר להשתמש בהתקנת Python קיימת על ידי ביטול הסימון של האפשרות להתקנת גרסת ה-Python שכלולה בחבילה. ב-gcloud topic startup מוסבר איך להשתמש בהתקנה קיימת של Python.
  3. בסיום ההתקנה, מנהל ההתקנה מאפשר ליצור קיצורי דרך לתפריט התחלה ולשולחן העבודה, להפעיל את המעטפת של Google Cloud CLI ולהגדיר את ה-CLI של gcloud. חשוב להשאיר את הסימון באפשרויות של הפעלת המעטפת והגדרת ההתקנה. מנהל ההתקנה מפעיל חלון טרמינל ומריץ את הפקודה gcloud init כדי לאתחל, לאשר ולהגדיר את ה-CLI של gcloud.
  4. התקנת ברירת המחדל לא כוללת את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות פקודות gcloud. אפשר להתקין את הרכיבים האלה באמצעות מנהל הרכיבים של ה-CLI של gcloud.

טיפים לפתרון בעיות

  • אם ההתקנה נכשלה כי המערכת לא זיהתה את הפקודה find, צריך לוודא שמשתנה הסביבה PATH מכיל את התיקייה שבה נמצאת הפקודה find. בדרך כלל זה הנתיב C:\WINDOWS\system32;.
  • אם הסרתם את ההתקנה של ה-CLI של gcloud, צריך להפעיל מחדש את המערכת לפני שמתקינים אותו שוב.
  • אם אי אפשר לפתוח את החבילה המכווצת, מריצים את מנהל ההתקנה כאדמין.

במסגרת ההתקנה של gsutil, צריך להגדיר את משתנה הסביבה CLOUDSDK_PYTHON כדי להשתמש בגרסת Python הנכונה. פרטים נוספים זמינים במאמר gcloud startup topic.

כדי לבצע עדכונים משתמשים בפקודה components update: gcloud components update.

הגדרת פרטי כניסה לגישה לנתונים מוגנים

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

כשמשתמשים ב-gsutil כחלק מ-Google Cloud CLI, האימות ואישור הגישה למשאבים ב-Cloud Storage מתבצע בעזרת הפרוטוקול OAuth2. כדי לספק גישה, מריצים את הפקודה gcloud init ומבצעים את ההוראות שבשורת הפקודה, כולל ההתחברות לחשבון המשתמש. שימו לב: יכול להיות שכבר השלמתם את ההגדרה הזו אם ביצעתם את שלבי ההתקנה. אם הרצתם את הפקודה gcloud init בעבר, כשתריצו אותה שוב תוצג שאלה אם לאתחל מחדש את ההגדרה או ליצור הגדרה חדשה. למידע נוסף, אפשר לקרוא את המאמר הפעלת Google Cloud CLI.

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

פתרון בעיות

אם ביצעתם אימות של gsutil באמצעות הפקודה gcloud init אבל עדיין אין לכם גישה לקטגוריות או לאובייקטים רצויים, יכול להיות שבנוסף לגרסת gsutil שמגיעה בחבילה עם Google Cloud CLI מותקנת במערכת גם הגרסה העצמאית מדור קודם של gsutil. כדי לבדוק את זה, מריצים את הפקודה gsutil version -l ובודקים את הערך של using cloud sdk. אם הערך הוא False, המשמעות היא שהמערכת משתמשת בגרסה העצמאית של gsutil כשאתם מריצים פקודות. מומלץ להסיר מהמערכת את הגרסה העצמאית של gsutil. אבל אתם יכולים גם לבצע אימות באמצעות הפקודה gsutil config -a או הפקודה gsutil config -e.

אימות באמצעות HMAC

השיטה המומלצת לאימות gsutil היא באמצעות OAuth 2.0, אבל אפשר גם להשתמש במפתחות HMAC בפרטי הכניסה. כדי לבצע אימות באמצעות HMAC, משתמשים בפקודה הבאה: 

gsutil config -a

הפקודה הזו תעביר אתכם לתהליך אימות שבו תתבקשו להזין את מזהה הגישה והסוד שמשויכים למפתח ה-HMAC.

כשמבצעים אימות באמצעות מפתחות HMAC צריך להשבית את האפשרות להעביר את פרטי הכניסה מ-Google Cloud CLI, באמצעות הפקודה: gcloud config set pass_credentials_to_gsutil false.

הפעלת mTLS

מומלץ גם להפעיל פרוטוקול TLS הדדי (mTLS). כש-mTLS מופעל במכשיר, המכשיר ינסה להתחבר אל נקודת הקצה של בקשת mTLS עבור API בפורמט JSON. לפני שהחיבור יוכל להתקיים, Cloud Storage מאמת את האישור שבמכשיר.

הדרך הכי פשוטה לקבל אישור היא באמצעות Google Cloud CLI. אפשר להגדיר אותו באופן ידני בקובץ ‎.boto על ידי הגדרת הערכים הבאים בקטע Credentials:

  1. ‫use_client_certificate: דגל שקובע האם להשתמש ב-mTLS או לא.
  2. ‫cert_provider_command: פקודת מעטפת שמדפיסה את האישור ל-stdout כדי ש-gsutil יוכל לקרוא אותו.

נסו בעצמכם

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

להתנסות ב-Cloud Storage בחינם