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

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

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

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz ‫93.5MB 817026aec0adea0e2ee8ed3a1ba3eabfe9e5177581fbe16595a8fe495a601300
    ‏Linux‏ 64 סיביות

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 54.1 MB c7b9abef0649e0fccc70bf2aaaa031a0aa6202863e45fabe938698dc93d4934c
    ‏Linux‏ 32 סיביות

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz ‫54.1MB 69f2e18bd0e706a6b31d005381bdf6b17ede01bcf6ce1804a42e2e7cef09bd9c

    כדי להוריד את קובץ הארכיון של 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 ‏(גרסה 3.10 עד 3.15).

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

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

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

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

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz ‫54.3MB b49e8cb9d348267d46fade7b9c916a1aed7ce0ec07e142ce41cc0d24a95a9651
    macOS‏ 64 סיביות

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz ‫54.2MB 71b37ca07ab0f9bc43898e42c913e10f143166230ab31e0bbea3632dbc77b010
    macOS ‏32-סיביות

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 52.6 MB bc9d328fbf56f650b57d9a70eb267993c98d0a9cbd15864b0b8fee949ea1039f

    אפשר גם להוריד את הארכיון משורת הפקודה. מחליפים את 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.14 ואת המודולים המומלצים, אם צריך.
    • מוסיפים את ה-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 ‏(גרסה 3.10 עד 3.15). גרסת 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 כולל רשימה של פקודות נפוצות ושימושיות ומושגים מרכזיים.