התקנת Google Cloud CLI

לפני שמבצעים את ההוראות במדריך הזה, כדאי לקרוא את המאמר הגדרת Google Cloud CLI עבור Cloud de Confiance.

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

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

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

התקנת גרסה 573.0.0 של ה-CLI של gcloud

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 ‫87.9MB 3d6b3c9d45873e0f1d69c48b754e2c35fa729dc3cf10d6c1754b4823f886590d
    ‏Linux‏ 64 סיביות

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz ‫60.8MB f9ca605f186ac186e161df191406e72728356bc950535ea0fcfcf74501d5fdad
    ‏Linux‏ 32 סיביות

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz ‫60.8MB f9e84d6bc95ff92ed021f8b8b99f64b6f4314482fd497f63746c1bb0943d5fc8

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

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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 בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.
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.0MB 4120743d00e42dfa0ae8609caff99c8bd90264b28ec3b2b70f629eea74c3d6dd
    macOS‏ 64 סיביות

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz ‫60.9MB 65582afb4c5f9f020831785978c8a0a158f627224bc3ac4573fae53c414abf00
    macOS ‏32-סיביות

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz ‫59.3MB d3cf00e96d387d2ed3a36462bf12931094700ff213e725d135aeac39fe672eaa

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

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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 בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.
Windows

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

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

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

    (New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/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.

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

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

אתחול והרשאה של ה-CLI של gcloud

אם אתם מאחורי שרת proxy או חומת אש, כדאי לעיין במאמר בנושא הגדרת שרת proxy כדי להפעיל גישה לרשת עבור ה-CLI של gcloud.

אחרי שמתקינים את ה-CLI של gcloud, צריך לאתחל אותו כדי לאשר גישה אל Cloud de Confiance ולהגדיר את ברירת המחדל. מידע נוסף זמין במאמר gcloud init.

  1. מריצים את הפקודה gcloud init כדי לאתחל את ה-CLI של gcloud:

    gcloud init

    כברירת מחדל, הפקודה הזו פותחת דפדפן אינטרנט כדי לאשר גישה. כדי לאשר גישה משורת הפקודה, מוסיפים את הדגל --console-only. כדי לאשר גישה באופן לא אינטראקטיבי, יוצרים חשבון שירות עם ההיקפים המתאימים במסוףCloud de Confiance , ואז משתמשים ב-gcloud auth activate-service-account עם קובץ מפתח ה-JSON שלו.

  2. פועלים לפי ההנחיות כדי לאשר ולהגדיר:

    • כשמוצגת בקשה להיכנס, מאשרים ואז נכנסים לחשבון Google בדפדפן. לוחצים על Allow (הפעלה) כדי לתת הרשאה לגשת למשאבים.

    • בוחרים פרויקט מתוך רשימת הפרויקטים שבהם יש לכם הרשאת בעלים, עריכה או צפייה. אם יש לכם רק פרויקט אחד, gcloud init בוחר בו אוטומטית.

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

    • אם הפעלתם את Compute Engine API, בוחרים את ברירת המחדל של אזור Compute Engine.

  3. אופציונלי: כדי לשפר את חוויית השימוש בקורא המסך, מפעילים את המאפיין accessibility/screen_reader באמצעות הפקודה הבאה:

    gcloud config set accessibility/screen_reader true

    מידע נוסף זמין במדריך הפעלת תכונות נגישות.

הרצת פקודות הליבה

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

  1. הצגת רשימה של חשבונות שפרטי הכניסה שלהם מאוחסנים במערכת המקומית:

    gcloud auth list

    ה-CLI של gcloud מציג רשימה של חשבונות שיש להם פרטי כניסה:

    Credentialed Accounts
ACTIVE             ACCOUNT
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

  2. הצגת רשימה של מאפייני ההגדרות האישיות של ה-CLI של gcloud הפעיל:

    gcloud config list

    ה-CLI של gcloud מציג את רשימת המאפיינים:

    [core]
account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
disable_usage_reporting = False
project = my-project

  3. הצגת מידע על פקודות gcloud ועל נושאים אחרים:

    gcloud help

    לדוגמה, כדי להציג את העזרה עבור gcloud compute instances create:

    gcloud help compute instances create

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

אופציונלי: התקנת רכיבים נוספים

כדי להתקין רכיבים נוספים כמו אמולטורים של App Engine,‏ kubectl או פקודות של ה-CLI של gcloud ברמת הגרסאות אלפא או בטא, אפשר לעיין במאמר בנושא ניהול רכיבי ה-CLI של gcloud.

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

  • קראו אתהמדריך ל-CLI של gcloud לסקירה כללית של ה-CLI של gcloud, כולל מבוא קצר על המושגים המרכזיים, הפקודות המקובלות וטיפים שימושיים.
  • קראו את מדריך העזר ל-CLI של gcloud לדפי הפרטים על כל אחת מהפקודות של ה-CLI של gcloud, כולל תיאורים, דגלים ודוגמאות, שישמשו אתכם לביצוע מגוון של משימות ב- Cloud de Confiance.
  • התקציר בנושא ה-CLI של gcloud כולל רשימה של פקודות נפוצות ושימושיות ומושגים מרכזיים.