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

התקנת גרסה 576.0.0 של gcloud 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.3MB a9561d76ee0fcbceff4caa8dc84376a5b1586d1bd25cc7f89f29fdb2a4e92ed4
    ‏Linux‏ 64 סיביות

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz ‫61.1MB 8bf879c65b2ca542150943e17b74ea41a006e900cb23283831476eeb4ced4544
    ‏Linux‏ 32 סיביות

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz ‫61.2MB 1f0f69ad802e3e945745fa2976e3753d5055bebc71cc8d100efd12d5e10af977

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

    (ARM64, Apple silicon)

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

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz ‫59.6MB 33a8cc483ecbbb87697ae6b6094763229697dc356d67cd06dec45b6cc58e417d

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

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