התקנת gsutil

חשוב: gsutil הוא לא ה-CLI המומלץ לעבודה עם Cloud Storage. במקום זאת, עדיף להשתמש בפקודות gcloud storage ב-Google Cloud CLI.

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

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

דרישות מערכת

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

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

הערה: התמיכה ב-Python 3.8 הוסרה מ-gsutil גרסה 5.35. כדי להבטיח תאימות לגרסאות עתידיות של gsutil, צריך לשדרג את סביבת Python לגרסה נתמכת (3.9 ומעלה).

בהוראות הבאות מוסבר איך לנהל גרסאות 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.

שימו לב: במהדורות מסוימות של Linux מותקן מראש כלי אחר בשם gsutil מסדרת GrandStream של BudgeTone. אם מריצים את הפקודה הזו במקום את ה-gsutil של Cloud Storage, סביר להניח שתקבלו הודעת שגיאה שדומה לזו: "Choose one of -b, -d, -e, or -r to do something". כדי לפתור את הבעיה, אפשר להעביר את הגרסה ל-gsutil של Cloud Storage להתחלת משתנה הסביבה PATH, או לציין את הנתיב המלא כשמריצים את gsutil של Cloud Storage (לדוגמה, /home/users/joan/gsutil/gsutil ls).

התקנת gsutil

הערה: אם התקנתם בעבר את Google Cloud CLI, אז gsutil כבר כלול. בנוסף, Google Cloud CLI, כולל gsutil, מותקן כברירת מחדל במספר תמונות של Google Compute Engine. רשימה מלאה מופיעה בפרטים על מערכת ההפעלה.

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

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

ל-Google Cloud CLI ול-gsutil יש יחסי תלות בגרסת Python, שיכולים לגרום לבעיות תאימות. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14, וב-gsutil צריך להשתמש ב-Python 3.9 עד 3.13.

כדי להתקין את gsutil, מומלץ להתקין אותו כחלק מ-Google Cloud CLI. אם בוחרים להתקין את gsutil ישירות, צריך להשתמש ב-Python 3.9 עד 3.13 כדי למנוע בעיות תאימות.

התקנת 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. מורידים אחת מהחבילות הבאות:
   הערה: כדי לדעת מה פלטפורמת Linux שלכם, מריצים את הפקודה uname -a בשורת הפקודה.

   פלטפורמה	שם חבילה	גודל	סיכום ביקורת (checksum)‏ SHA256
   ‏Linux‏ 64 סיביות (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	‫203.9MB	848bd5a9118f52e42fbbf690fbd7bc7686477ac41640ef4962bcb8fda7050781
   ‏Linux‏ 64 סיביות (Arm)	google-cloud-cli-linux-arm.tar.gz	‫58.8MB	b90992b8dea95e8ba0afcdd387836494018a3061c85379222b72b33c858449be
   ‏Linux‏ 32 סיביות (x86)	google-cloud-cli-linux-x86.tar.gz	‫58.8MB	f1ea7162b3882f4d25a4d7d9dee1c552ee80cbc506f36bcffff81a862c85a8e5

   כדי להוריד את קובץ הארכיון של 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. את הרכיבים האלו תצטרכו להתקין בנפרד בהתאם לצורך.

הערה: יש שיטות התקנה חלופיות להגדרות ספציפיות:

• אם אתם מריצים גרסה מודרנית של Ubuntu עם מנהל החבילות Snap ואתם רוצים עדכונים אוטומטיים, אתם יכולים להתקין את Google Cloud CLI כחבילת snap.
• אם אתם משתמשים במכונה ב-Compute Engine, יכול להיות שה-CLI של gcloud כבר מותקן. רשימה של תמונות של מערכות הפעלה שכוללות את ה-CLI כברירת מחדל זמינה במאמר פרטי מערכת הפעלה.

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

לפני שמתקינים את ה-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

   הערה: מוודאים שאין רשומות כפולות של המאגר cloud-sdk ב-/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-validator
   • 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 שאותן אפשר להתקין בנפרד, כמו שמתואר בהמשך.

הערה: אם אתם משתמשים במכונה ב-Compute Engine, ‏Google Cloud CLI מותקן כברירת מחדל במספר תמונות של מערכות הפעלה. לרשימה מלאה

התקנה

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

2. מתקינים את libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. מתקינים את ה-CLI של gcloud:

   sudo dnf install google-cloud-cli

   הערה: אם לא העברתם את המערכת ל-dnf, תוכלו להריץ את הפקודות האלה באמצעות yum.

   בפקודות האלה תוכלו גם להשתמש באפשרויות של dnf ו-yum, כמו השבתת ההנחיות או הפעלת הרצת בדיקה.

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.

   אם צריך, סקריפט ההתקנה יכול להתקין את Python בשבילכם. לשם כך נדרשים כלי שורת הפקודה של Xcode. כדי להתקין אותם, מריצים את הפקודה sudo xcode-select --install. אפשר גם להתקין גרסה נתמכת של Python מכתובת python.org.

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

2. מורידים אחת מהחבילות הבאות:
   הערה: כדי לדעת מה הפלטפורמה, מריצים את הפקודה uname -m משורת הפקודה.

   פלטפורמה	חבילה	גודל	סיכום ביקורת (checksum)‏ SHA256
   macOS‏ 64 סיביות (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	‫58.9MB	5528851105fe3156773b46ad4f4ab1be85697370dc208c2d3e50401d0dd8105b
   macOS‏ 64 סיביות (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	‫58.8MB	21af3d7c17ca0e261ff711ff64882de5e9b5884876d4da5ad38187a3dab33fd6
   macOS ‏32-סיביות (x86)	google-cloud-cli-darwin-x86.tar.gz	‫57.3MB	d6242266b97e182fe584ba875801edee7f2d5644e904c27efed09709cefcadb8

   אפשר גם להוריד את הארכיון משורת הפקודה. מחליפים את 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 ‏(גרסה 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 מאמת את האישור שבמכשיר.

הערה: התכונה הזו פועלת רק כש-gsutil שולח בקשות דרך 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 בחינם