Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

התקנת Google Cloud CLI

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

לחצו על תראו לי איך כדי לקרוא הסבר מפורט על המשימה ישירות במסוף Google Cloud :

תראו לי איך

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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

Verify that billing is enabled for your Google Cloud project.

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

Linux

קודם מוודאים שיש תמיכה בגרסת Python שלכם. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14. חבילת x86_64 של Linux כוללת מתורגמן Python בחבילה, שיקבל עדיפות כברירת מחדל. במאמרי העזרה בנושא gcloud topic startup מוסבר איך בוחרים את רכיב התרגום ב-Python ואיך מגדירים אותו.

מורידים אחת מהחבילות הבאות:

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

פלטפורמה	שם חבילה	גודל	סיכום ביקורת (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://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 שרלוונטי להגדרה שלכם.

כדי לחלץ את התוכן של הקובץ למערכת הקבצים, מריצים את הפקודה הבאה:
```
tar -xf google-cloud-cli-linux-x86_64.tar.gz
```
כדי להחליף התקנה קיימת, מוחקים את ספריית google-cloud-sdk הקיימת ומחלצים את קובץ הארכיון לאותו המיקום.
מריצים את סקריפט ההתקנה מהרמה הבסיסית (root) של התיקייה שאליה חילצתם את הקבצים:
```
./google-cloud-sdk/install.sh
```
הסקריפט יבקש מכם לבצע את פעולות ההגדרה הבאות. כדי לאשר, עונים Y כשמוצגת הבקשה.
- מוסיפים את ה-CLI של gcloud ל-PATH.
- מפעילים את השלמת הפקודות.
- מסכימים לשלוח נתוני שימוש אנונימיים כדי לעזור לשפר את ה-CLI של gcloud.
אפשר גם לבצע את ההתקנה באופן לא אינטראקטיבי על ידי ציון דגלים. כדי לראות את הדגלים הזמינים מריצים את הפקודה:
```
./google-cloud-sdk/install.sh --help
```
אופציונלי: אם עדכנתם את PATH בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.

Debian/Ubuntu

תכולת החבילה

ה-CLI של gcloud זמין בפורמט של חבילה להתקנה במערכות Debian ו-Ubuntu. החבילה הזו כוללת רק את כלי שורת הפקודה gcloud,‏ gcloud alpha,‏ gcloud beta,‏ gsutil ו-bq. היא לא כוללת את הפקודה kubectl או את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות פקודות gcloud. את הרכיבים האלו תצטרכו להתקין בנפרד בהתאם לצורך.

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

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

מותקנת גרסת Ubuntu שלא הגיעה לסוף חיי המוצר או גרסה יציבה של Debian שלא הגיעה לסוף חיי המוצר.
החבילות שבה התעדכנו לאחרונה. כדי לעשות זאת עכשיו, מריצים את הפקודה הבאה:
```
sudo apt-get update
```
מותקנות בה הפקודות ca-certificates,‏ gnupg ו-curl. כדי להתקין את החבילות האלה, מריצים את הפקודה הבאה:
```
sudo apt-get install ca-certificates gnupg curl
```

התקנה

מייבאים את 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 העדכני.
מוסיפים את 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.
עדכון והתקנת ה-CLI של gcloud:
‫
```
sudo apt-get update && sudo apt-get install google-cloud-cli
```
הערה: אם מתקינים במכונות וירטואליות עם מגבלות על משאבים, בתמונות של קונטיינרים או ב-runners אוטומטיים של CI/CD, אפשר לייצא את משתנה הסביבה CLOUDSDK_SKIP_PY_COMPILATION=1 במהלך ההתקנה כדי לדלג על קומפילציה של Python בצד המארח. כך אפשר לקצר את זמן התקנת החבילה מדקות לשניות:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 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
      
```
אופציונלי: התקנת רכיבים נוספים:
- 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-tools
- google-cloud-cli-tests
- kubectl
לדוגמה, את הרכיב google-cloud-cli-app-engine-java אפשר להתקין כך:
```
sudo apt-get install google-cloud-cli-app-engine-java
```

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

התקנה

מעדכנים את 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
```
- בהתקנות של ARM64 ‏ (aarch64), משתמשים ב-https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (תואם ל-RHEL 7,‏ 8 או 9) או ב-https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (תואם ל-RHEL 10) כערך של baseurl.

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

sudo dnf install libxcrypt-compat.x86_64

מתקינים את ה-CLI של gcloud:
‫
```
sudo dnf install google-cloud-cli
```
הערה: אם מתקינים במכונות וירטואליות עם מגבלות על משאבים, בתמונות של קונטיינרים או ב-runners אוטומטיים של CI/CD, אפשר לייצא את משתנה הסביבה CLOUDSDK_SKIP_PY_COMPILATION=1 במהלך ההתקנה כדי לדלג על קומפילציה של Python בצד המארח. כך אפשר לקצר את זמן התקנת החבילה מדקות לשניות:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli
```
הגדרת המשתנה הזה מדלגת על קומפילציה של בייטים בהתקנה, ומקצרת את זמן ההגדרה של החבילה על חשבון תקורה קלה של ביצוע פקודות אינטראקטיביות.
הערה: אם לא העברתם את המערכת ל-dnf, תוכלו להריץ את הפקודות האלה באמצעות yum.
בפקודות האלה תוכלו גם להשתמש באפשרויות של dnf ו-yum, כמו השבתת ההנחיות או הפעלת הרצת בדיקה.
אופציונלי: התקנת רכיבים נוספים:
- 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
```

שדרוג לאחור של גרסאות ה-CLI של gcloud

כדי לחזור לגרסה קודמת ספציפית של ה-CLI של gcloud, מריצים את הפקודה הבאה. מחליפים את 123.0.0 בגרסה שרוצים להתקין:

sudo dnf downgrade google-cloud-cli-123.0.0

עשר הגרסאות האחרונות זמינות במאגר. בגרסאות שלפני 371.0.0, שם החבילה הוא google-cloud-sdk.

macOS

קודם מוודאים שיש תמיכה בגרסת Python שלכם. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14.
כדי לבדוק איזו גרסה של Python מותקנת, מריצים את הפקודה python3 -V או את הפקודה python -V.

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

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

מורידים אחת מהחבילות הבאות:

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

פלטפורמה	חבילה	גודל	סיכום ביקורת (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://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME

מחלצים את תוכן הקובץ למיקום המועדף במערכת הקבצים. נהוג לחלץ אותו לספריית הבית.
ב-macOS, אפשר לעשות את זה על ידי פתיחת הקובץ שהורדתם .tar.gz במיקום הרצוי. לחלופין, משורת הפקודה, מריצים את הפקודה:
```
tar -xf FILE_NAME
```
כדי להחליף התקנה קיימת, מסירים את ספריית google-cloud-sdk הקיימת ומחלצים את קובץ הארכיון לאותו המיקום.
מריצים את סקריפט ההתקנה מהרמה הבסיסית (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
```
אופציונלי: אם עדכנתם את PATH בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.

Windows

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

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

מפעילים את מנהל ההתקנה וממשיכים בהתאם להנחיות. מנהל ההתקנה חתום על ידי 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.
בסיום ההתקנה, מנהל ההתקנה מאפשר ליצור קיצורי דרך לתפריט התחלה ולשולחן העבודה, ולהפעיל את המעטפת של Google Cloud CLI. מבטלים את הסימון של האפשרות להפעלת המעטפת. בשלבים הבאים תריצו ותגדירו את ה-CLI של gcloud.

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

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

Chromebook

מגדירים את סביבת הפיתוח של Linux ב-Chromebook.

מוסיפים את URI ההפצה של ה-CLI של gcloud בתור מקור של חבילה. מריצים את הפקודה הבאה:

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

מייבאים את Google Cloud המפתח הציבורי:

curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

עדכון והתקנת ה-CLI של gcloud:

sudo apt-get update && sudo apt-get install google-cloud-cli

אופציונלי: התקנת רכיבים נוספים:
- 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
```

שדרוג לאחור של גרסאות ה-CLI של gcloud

כדי לחזור לגרסה קודמת ספציפית של ה-CLI של gcloud, מריצים את הפקודה הבאה. מחליפים את 123.0.0 בגרסה שרוצים להתקין:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

עשר הגרסאות האחרונות זמינות במאגר. בגרסאות שלפני 371.0.0, שם החבילה הוא google-cloud-sdk.

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

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

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

מריצים את הפקודה gcloud init כדי לאתחל את ה-CLI של gcloud:
```
gcloud init
```
כברירת מחדל, הפקודה הזו פותחת דפדפן אינטרנט כדי לאשר גישה. כדי לאשר גישה משורת הפקודה, מוסיפים את הדגל --console-only. כדי לאשר גישה באופן לא אינטראקטיבי, יוצרים חשבון שירות עם ההיקפים המתאימים במסוףGoogle Cloud , ואז משתמשים ב-gcloud auth activate-service-account עם קובץ מפתח ה-JSON שלו.
פועלים לפי ההנחיות כדי לאשר ולהגדיר:
- כשמוצגת בקשה להיכנס, מאשרים ואז נכנסים לחשבון Google בדפדפן. לוחצים על Allow (הפעלה) כדי לתת הרשאה לגשת למשאבים.
- בוחרים פרויקט מתוך רשימת הפרויקטים שבהם יש לכם הרשאת בעלים, עריכה או צפייה. אם יש לכם רק פרויקט אחד, gcloud init בוחר בו אוטומטית.
  
  אם יש לכם יותר מ-200 פרויקטים, תופיע הנחיה להזין מזהה פרויקט, ליצור פרויקט או להציג את רשימת הפרויקטים. אם בוחרים ליצור פרויקט, צריך גם להפעיל בו את אפשרות החיוב.
- אם הפעלתם את Compute Engine API, בוחרים את ברירת המחדל של אזור Compute Engine.
אופציונלי: כדי לשפר את חוויית השימוש בקורא המסך, מפעילים את המאפיין accessibility/screen_reader באמצעות הפקודה הבאה:
```
gcloud config set accessibility/screen_reader true
```
מידע נוסף זמין במדריך הפעלת תכונות נגישות.

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

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

הצגת רשימה של חשבונות שפרטי הכניסה שלהם מאוחסנים במערכת המקומית:
```
gcloud auth list
```
ה-CLI של gcloud מציג רשימה של חשבונות שיש להם פרטי כניסה:
```
Credentialed Accounts
ACTIVE             ACCOUNT
*                  example-user-1@example.com
                   example-user-2@example.com
```
הצגת רשימה של מאפייני ההגדרות האישיות של ה-CLI של gcloud הפעיל:
```
gcloud config list
```
ה-CLI של gcloud מציג את רשימת המאפיינים:
```
[core]
account = example-user-1@example.com
disable_usage_reporting = False
project = example-project
```
הצגת מידע על פקודות 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, כולל תיאורים, דגלים ודוגמאות, שישמשו אתכם לביצוע מגוון של משימות ב- Google Cloud.
התקציר בנושא ה-CLI של gcloud כולל רשימה של פקודות נפוצות ושימושיות ומושגים מרכזיים.