התקנת 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.

התקנת גרסה 575.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 ‫88.1MB e571c68f173e691c400d435b929d204f94b29a634e36d5ffcd97140e802bb385
    ‏Linux‏ 64 סיביות

    (Arm)

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

    (x86)

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

    כדי להוריד את קובץ הארכיון של 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.2MB 12f5205cc7be8c1cdea4180c8a0d6b5f6e1d9a3dc033024bc6f2edc8dce489fb
    macOS‏ 64 סיביות

    (ARM64, Apple silicon)

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

    (x86)

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

    אפשר גם להוריד את הארכיון משורת הפקודה. מחליפים את 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 כולל רשימה של פקודות נפוצות ושימושיות ומושגים מרכזיים.