Diese Seite enthält eine Anleitung zum Auswählen und Verwalten einer Installation der Google Cloud CLI. Die Google Cloud CLI enthält die gcloud
-, gsutil
- und bq
-Befehlszeilentools. Eine Liste der Funktionen der gcloud CLI finden Sie unter Alle Features.
Wenn Sie mit einer unterstützten Programmiersprache auf die Google Cloud APIs zugreifen möchten, können Sie die Cloud-Clientbibliotheken herunterladen.
Installationsanleitung
Diese Anleitung bezieht sich auf die Installation der Google Cloud CLI. Informationen zum Installieren zusätzlicher Komponenten wie gcloud CLI-Befehle auf Alpha- oder Betaversion finden Sie unter gcloud CLI-Komponenten verwalten.
- Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.8 bis 3.11. Beachten Sie, dass das x86_64-Linux-Paket einen gebündelten Python-Interpreter enthält, der standardmäßig bevorzugt wird. Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter
gcloud topic startup
. - Laden Sie eine der folgenden Dateien herunter:
Plattform Paketname Größe SHA256-Prüfsumme Linux 64-Bit (x86_64)
google-cloud-cli-455.0.0-linux-x86_64.tar.gz 199,2 MB cffa560f0820ffe2390ccb73c4def91bba8fa2d0c9244f6207e190cee3d2287d Linux 64-Bit (Arm)
google-cloud-cli-455.0.0-linux-arm.tar.gz 117,1 MB ad6031ecc452b48aeb28ead5287d1b22a6bddf5950420759f8eb64c04d1d0556 Linux 32-Bit (x86)
google-cloud-cli-455.0.0-linux-x86.tar.gz 115,2 MB 271ac3c227a34c7290e7f0be8d8dde3378d91b7c7acf7a6f3687293221b37e9a Führen Sie den folgenden Befehl aus, um die Linux-Archivdatei herunterzuladen:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-455.0.0-linux-x86_64.tar.gz
Ersetzen Sie google-cloud-cli-455.0.0-linux-x86_64.tar.gz anhand der obigen Tabelle durch den Paketnamen
*.tar.gz
, der für Ihre Konfiguration gilt. - Führen Sie den folgenden Befehl aus, um den Inhalt der Datei in Ihr Dateisystem (vorzugsweise in Ihr Basisverzeichnis) zu extrahieren:
tar -xf google-cloud-cli-455.0.0-linux-x86_64.tar.gz
Optional: Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandenegoogle-cloud-sdk
-Verzeichnis und extrahieren Sie dann das Archiv an denselben Speicherort. - Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installations-Script aus dem Stammverzeichnis des Ordners, in den Sie extrahiert haben, mit dem folgenden Befehl aus:
./google-cloud-sdk/install.sh
Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Skripts) und indem Sie Einstellungen als Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen:./google-cloud-sdk/install.sh --help
Optional:- Wenn Sie anonyme Nutzungsstatistiken senden möchten, um die gcloud CLI zu verbessern, antworten Sie mit
Y
, wenn Sie dazu aufgefordert werden. -
Wenn Sie die gcloud CLI zu
PATH
hinzufügen und die Befehlsvervollständigung aktivieren möchten, antworten Sie mitY
, wenn Sie dazu aufgefordert werden.
- Wenn Sie anonyme Nutzungsstatistiken senden möchten, um die gcloud CLI zu verbessern, antworten Sie mit
- Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
- Führen Sie
gcloud init
aus, um die gcloud CLI zu initialisieren: - Optional: Installieren Sie zusätzliche Komponenten mit dem Komponentenmanager.
./google-cloud-sdk/bin/gcloud init
Paketinhalt
Die gcloud CLI ist im Paketformat für die Installation auf Debian- und Ubuntu-Systemen verfügbar.
Dieses Paket umfasst nur die Befehle von gcloud
, gcloud alpha
, gcloud beta
, gsutil
und bq
. Nicht enthalten sind kubectl
oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud
-Befehlen erforderlich sind. Wenn Sie diese Komponenten benötigen, müssen Sie sie separat installieren.
Prüfen Sie vor der Installation der gcloud CLI, ob Ihr Betriebssystem die folgenden Anforderungen erfüllt:
- Es ist ein Ubuntu-Release, das das Ende des Produktzyklus noch nicht erreicht hat, oder ein stabiler Debian-Release, der das Ende des Produktzyklus noch nicht erreicht hat.
- Die Pakete wurden vor Kurzem aktualisiert:
sudo apt-get update
- Hier sind
apt-transport-https
undcurl
installiert:sudo apt-get install apt-transport-https ca-certificates gnupg curl sudo
- Importieren Sie den öffentlichen Google Cloud-Schlüssel.
Führen Sie für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) den folgenden Befehl aus:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
- Führen Sie für ältere Distributionen den folgenden Befehl aus:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
Wenn der Befehl „apt-key“ Ihrer Distribution das Argument
--keyring
nicht unterstützt, führen Sie den folgenden Befehl aus:curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
Wenn Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle Schlüsseldatei „apt-get.gpg“ ab.
- Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu.
- Führen Sie für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) den folgenden Befehl aus:
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
Führen Sie für ältere Distributionen, die die Option „signiert von“ nicht unterstützen, den folgenden Befehl aus:
echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
- Führen Sie für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) den folgenden Befehl aus:
- Aktualisieren Sie die gcloud CLI und installieren Sie sie:
sudo apt-get update && sudo apt-get install google-cloud-cli
Weitereapt-get
-Optionen, z. B. zum Deaktivieren von Eingabeaufforderungen oder Probeläufen, finden Sie auf denapt-get
-manpages.Docker-Tipp: Wenn Sie die gcloud CLI in einem Docker-Image installieren, verwenden Sie stattdessen einen einzigen RUN-Schritt:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
Für ältere Basis-Images, die den Befehlgpg --dearmor
nicht unterstützen:RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://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
- Optional: Installieren Sie eine der folgenden
zusätzlichen Komponenten:
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
Die Komponente
google-cloud-cli-app-engine-java
kann beispielsweise so installiert werden:sudo apt-get install google-cloud-cli-app-engine-java
- Führen Sie
gcloud init
aus, um zu beginnen:gcloud init
Downgrade auf gcloud CLI-Versionen ausführen
Führen Sie den folgenden Befehl aus, um eine bestimmte Version der gcloud CLI wiederherzustellen, wobei VERSION
das Format 123.0.0
hat:
sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0
Die zehn neuesten Releases sind immer im Repository verfügbar.
HINWEIS: Bei Versionen vor 371.0.0 lautet der Paketname google-cloud-sdk
.
Paketinhalt
Die gcloud CLI ist im Paketformat für die Installation auf Red Hat Enterprise Linux 7, 8 und 9, Fedora 33 und 34 sowie CentOS 7 und 8 verfügbar.
Dieses Paket umfasst nur die Befehle von gcloud
, gcloud alpha
, gcloud beta
, gsutil
und bq
. Nicht enthalten sind kubectl
oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud
-Befehlen erforderlich sind. Diese können wie unten in diesem Abschnitt separat installiert werden.
- Aktualisieren Sie DNF mit Repository-Informationen der gcloud CLI.
Sehen Sie sich die Liste der verfügbaren Pakete an.
Der folgende Beispielbefehl bezieht sich auf eine mit Red Hat Enterprise Linux 9 kompatible Installation. Sie müssen jedoch die Einstellungen nach Bedarf für Ihre Konfiguration aktualisieren:
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
-
Wenn Sie auf Fedora 34 oder 35 installieren, installieren Sie
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installieren Sie die gcloud CLI:
sudo dnf install google-cloud-cli
- Optional: Installieren Sie eine der folgenden zusätzlichen Komponenten:
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
Die Komponente
google-cloud-cli-app-engine-java
kann beispielsweise so installiert werden:sudo dnf install google-cloud-cli-app-engine-java
- Führen Sie
gcloud init
aus, um zu beginnen:gcloud init
Downgrade auf gcloud CLI-Versionen ausführen
Wenn Sie eine bestimmte Version der gcloud CLI wiederherstellen möchten, wobei VERSION
das Format 123.0.0
hat, führen Sie Folgendes aus:
sudo dnf downgrade google-cloud-cli-VERSION
Die letzten zehn Releases sind immer im Repository verfügbar.
HINWEIS: Bei Versionen vor 371.0.0 lautet der Paketname google-cloud-sdk
.
-
Prüfen Sie, ob Sie eine unterstützte Version von Python haben:
-
Um Ihre aktuelle Python-Version zu prüfen, führen Sie
python3 -V
oderpython -V
aus. Unterstützte Versionen sind Python 3.8 bis 3.11. - Das Hauptinstallationsskript bietet die Installation von Python 3.11 von CPython an.
- Wenn Sie eine unterstützte Python-Version installieren möchten, besuchen Sie die Python-Releases für macOS von Python.org.
- Wenn auf Ihrem Computer mehrere Python-Interpreter installiert sind, legen Sie die Umgebungsvariable CLOUDSDK_PYTHON in Ihrer Shell so fest, dass sie auf den Pfad Ihres bevorzugten Interpreters verweist.
-
Weitere Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter
gcloud topic startup
.
-
Um Ihre aktuelle Python-Version zu prüfen, führen Sie
- Laden Sie eine der folgenden Optionen herunter:
-
Entpacken Sie das Archiv in einem Verzeichnis Ihres Dateisystems, vorzugsweise im Basisverzeichnis. Unter macOS erreichen Sie dies, indem Sie die heruntergeladene Archivdatei
.tar.gz
am bevorzugten Speicherort öffnen.Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandene
google-cloud-sdk
-Verzeichnis und extrahieren Sie dann das Archiv an denselben Speicherort. -
Optional: Verwenden Sie das Installationsskript, um gcloud CLI-Tools zu
PATH
hinzuzufügen.Sie können auch die Vervollständigung von Shell-Befehlen aktivieren, das Erfassen von Nutzungsstatistiken und Python 3.11 installieren.Führen Sie das Skript (vom Stammverzeichnis des im letzten Schritt extrahierten Ordners) mit dem folgenden Befehl aus:
./google-cloud-sdk/install.sh
Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Skripts), indem Sie Einstellungen als Flags angeben. Führen Sie folgenden Befehl aus, um die verfügbaren Flags zu beschreiben:./google-cloud-sdk/install.sh --help
So führen Sie das Installationsskript mit aktiviertem Screenreader-Modus aus:./google-cloud-sdk/install.sh --screen-reader=true
Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden. -
Führen Sie
gcloud init
aus, um die gcloud CLI zu initialisieren: - Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Plattform | Paket | Größe | SHA256-Prüfsumme |
---|---|---|---|
macOS 64-Bit
(x86_64) |
google-cloud-cli-455.0.0-darwin-x86_64.tar.gz | 122,8 MB | 561db89e1eb9c84329fa267c7b60ea2eb31752bd90c399d316eb372903fb9fd9 |
macOS 64-Bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-455.0.0-darwin-arm.tar.gz | 119,9 MB | c92972969d6f07e312226fbc133546b5e679a7882a8e2063c1fcc67773eadb1f |
macOS 32-Bit
(x86) |
google-cloud-cli-455.0.0-darwin-x86.tar.gz | 121,5 MB | 44c2165dcfc7d2a5430bd2190444bf72c87f2ce3ddc2500a9cf69161f534bad6 |
./google-cloud-sdk/bin/gcloud init
-
Die Google Cloud CLI funktioniert mit Windows 8.1 und höher und Windows Server 2012 und höher.
-
Laden Sie das Installationsprogramm für die Google Cloud-CLI herunter.
Alternativ können Sie ein PowerShell-Terminal öffnen und die folgenden PowerShell-Befehle ausführen:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
Starten Sie das Installationsprogramm und folgen Sie den Anweisungen. Das Installationsprogramm ist von Google LLC signiert.
Wenn Sie einen Screenreader verwenden, klicken Sie auf das Kästchen Screenreader-Modus aktivieren. Diese Option konfiguriert
gcloud
so, dass Status-Tracker anstelle von rotierenden Unicode-Ladesymbolen verwendet, die Fortschritt als Prozentsatz angezeigt und Tabellen vereinfacht werden. Weitere Informationen finden Sie im Leitfaden zu Bedienungshilfen. -
Die Google Cloud CLI erfordert Python. Unterstützte Versionen sind Python 3.8 bis 3.11. Die Windows-Version der Google Cloud CLI ist standardmäßig in Python 3 enthalten. Um die Google Cloud CLI verwenden zu können, muss das Betriebssystem in der Lage sein, eine unterstützte Version von Python auszuführen.
Das Installationsprogramm installiert alle notwendigen Abhängigkeiten, darunter die erforderliche Version von Python. Die Google Cloud CLI installiert und verwaltet Python 3 standardmäßig, kann aber bei Bedarf eine vorhandene Python-Installation verwenden. Dazu deaktivieren Sie die Option zum gebündelten Installieren von Python. Unter
gcloud topic startup
erfahren Sie, wie Sie eine vorhandene Python-Installation verwenden. Nach Abschluss der Installation haben Sie die Möglichkeit, das Startmenü und die Desktopverknüpfungen zu erstellen, die Google Cloud CLI-Shell zu starten und die gcloud CLI zu konfigurieren. Achten Sie darauf, dass die Optionen zum Starten der Shell und zum Konfigurieren der Installation ausgewählt bleiben. Das Installationsprogramm startet ein Terminalfenster und führt den Befehl
gcloud init
aus.- Die Standardinstallation umfasst nicht die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit
gcloud
-Befehlen erforderlich sind. Diese Komponenten können mit dem Komponentenmanager der gcloud CLI installiert werden.
- Wenn die Installation aufgrund der Nichterkennung des Befehls
find
fehlschlägt, achten Sie darauf, dass die UmgebungsvariablePATH
so eingestellt ist, dass sie den Ordner mitfind
enthält. Normalerweise ist diesC:\WINDOWS\system32;
. - Wenn Sie die gcloud CLI deinstalliert haben, müssen Sie Ihr System neu starten, bevor Sie die gcloud CLI noch einmal installieren.
- Wenn das Entpacken fehlschlägt, führen Sie das Installationsprogramm als Administrator aus.
Weitere Installationsoptionen
Je nach Ihren Entwicklungsanforderungen können Sie anstelle der empfohlenen Installation eine alternative Methode zur Installation der gcloud CLI verwenden:
- Verwenden Sie die gcloud CLI mit Skripts oder einer kontinuierlichen Integration/Bereitstellung? Laden Sie ein versioniertes Archiv für eine nicht interaktive Installation einer bestimmten Version der gcloud CLI herunter.
- Sie möchten die gcloud CLI als Docker-Image ausführen? Verwenden Sie das Docker-Image der gcloud CLI für den neuesten Release (oder eine bestimmte Version) der gcloud CLI.
- Sie nutzen Ubuntu und bevorzugen automatische Aktualisierungen? Verwenden Sie ein Snap-Paket, um die gcloud CLI zu installieren.
- Führen Sie für interaktive Windows- und macOS-Installationen und alle anderen Anwendungsfälle das interaktive Installationsprogramm aus, um den neuesten Release der gcloud CLI zu installieren.
Installation verwalten
Nachdem Sie die gcloud CLI installiert haben, können Sie Befehle in der gcloud components
-Befehlsgruppe verwenden, um Ihre Installation zu verwalten. Dazu gehören das Ansehen von installierten Komponenten, das Hinzufügen und Entfernen von Komponenten sowie das Upgrade auf eine neue Version oder ein Downgrade auf eine bestimmte Version der gcloud CLI.
Frühere Versionen der gcloud CLI
Wenn Sie eine andere Version der gcloud CLI benötigen, installieren Sie die aktuelle Version anhand der Anleitung weiter oben auf dieser Seite und melden Sie sich dann an. Nachdem Sie sich angemeldet haben, können Sie frühere Releases herunterladen. Wenn Sie die Versionen nach Datum sortiert sehen möchten, aktivieren Sie Sortieren und filtern und klicken Sie auf die Spalte Erstellt.
Unterstützte Python-Versionen
Für die Google Cloud CLI ist Python 3.8 bis 3.11 erforderlich. Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup
.
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Jetzt kostenlos starten