gcloud-CLI installieren

Diese Seite enthält eine Anleitung zum Auswählen und Verwalten einer Google Cloud CLI Installation. Die Google Cloud CLI enthält gcloud, gsutil und bq Befehlszeilentools. Eine Liste der Features der gcloud CLI finden Sie unter Alle Funktionen:

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 zu zusätzliche Komponenten wie gcloud CLI-Befehle unter Alpha- oder Beta-Release-Level, siehe gcloud CLI-Komponenten verwalten

Hinweis: Wenn Sie sich hinter einem Proxy oder einer Firewall befinden, lesen Sie die Proxy-Einstellungen finden Sie weitere Informationen zu der Installation.

<ph type="x-smartling-placeholder">

</ph> <ph type="x-smartling-placeholder">

</ph>

Linux

1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.8 bis 3.12). 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.
2. Laden Sie eine der folgenden Dateien herunter:
   Hinweis: Führen Sie getconf LONG_BIT in der Befehlszeile aus, um die Linux-Version Ihres Betriebssystems zu ermitteln.

   Plattform	Paketname	Größe	SHA256-Prüfsumme
   Linux 64-Bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	130.3 MB	29e19b666935c05f81862324fbbda3d798a49909606b45512f732ae642553759
   Linux 64-Bit (Arm)	google-cloud-cli-linux-arm.tar.gz	52,7 MB	36e3c4e47cec39a4cf0e85aa156f7c61f096db6b698d644a2ef4b48c4210f19d
   Linux 32-Bit (x86)	google-cloud-cli-linux-x86.tar.gz	52,7 MB	87cec76678aa9fe8ee28846c4c9ba4413036620eec72db38856d6e24c49e338a

   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-linux-x86_64.tar.gz

   Orientieren Sie sich an der Tabelle oben und ersetzen Sie google-cloud-cli-linux-x86_64.tar.gz durch den *.tar.gz-Paketname, der für Ihre Konfiguration gilt.

3. Um den Inhalt der Datei in Ihr Dateisystem zu extrahieren (vorzugsweise Ihrem Basisverzeichnis), führen Sie den folgenden Befehl aus:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Optional: Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie die vorhandene google-cloud-sdk und entpacken Sie dann das Archiv in den denselben Standort haben.
4. Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installationsskript vom Stammverzeichnis des Ordner, in den Sie extrahiert haben, mit dem folgenden Befehl:

   ./google-cloud-sdk/install.sh

   Dies kann auch nicht interaktiv (z. B. mithilfe eines Scripts) und durch Angabe von Einstellungen erfolgen. als Markierungen. 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 zur Verbesserung der gcloud-Befehlszeile zu beitragen, antworten Sie auf Y, wenn Sie dazu aufgefordert werden.
   • Wenn Sie die gcloud CLI zu PATH hinzufügen und die Befehlsvervollständigung aktivieren möchten, antworten Sie mit Y, wenn Sie dazu aufgefordert werden.
5. Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
6. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:

./google-cloud-sdk/bin/gcloud init

7. Optional: Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.

Debian/Ubuntu

Hinweis: Je nach Konfiguration können Sie auch andere Installationsmethoden auswählen:

• Wenn Sie möchten, dass gcloud automatisch auf die neueste Version aktualisiert wird und Sie einer modernen Ubuntu-Version, die den Snap Package Manager nutzt, Google Cloud CLI als Snap-Paket
• Wenn Sie eine Instanz in Compute Engine verwenden, ist die gcloud CLI die standardmäßig auf mehreren Betriebssystem-Images installiert sind. Eine vollständige Liste finden Sie unter Details zum Betriebssystem.

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.

Hinweis

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.
• Es hat vor Kurzem seine Pakete aktualisiert:

  sudo apt-get update

• Es hat apt-transport-https und curl installiert:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Installation

1. Importieren Sie den öffentlichen Google Cloud-Schlüssel.

   • Für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) führen Sie 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 bei älteren 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 apt-get.gpg-Schlüsseldatei ab.

2. Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu.
   • Für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) führen Sie 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 signed-by 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

   Hinweis: Achten Sie darauf, dass Sie keine doppelten Einträge für das Repository cloud-sdk in /etc/apt/sources.list.d/google-cloud-sdk.list haben.
3. Aktualisieren und installieren Sie die gcloud CLI:

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

   Für zusätzliche apt-get-Optionen wie das Deaktivieren von Eingabeaufforderungen oder Probeläufen: Weitere Informationen finden Sie auf den apt-get-man-Seiten.

   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] 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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   Für ältere Basis-Images, die den Befehl gpg --dearmor nicht unterstützen:

   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
         

4. (Optional) Installieren Sie eine oder mehrere 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

5. 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.

Red Hat/Fedora/CentOS

Hinweis: Wenn Sie eine Instanz in Compute Engine verwenden, ist die Google Cloud CLI die standardmäßig auf mehreren Betriebssystem-Images installiert sind. Weitere Informationen finden Sie unter Unter Betriebssystemdetails finden Sie eine vollständige Liste.

Paketinhalt

Die gcloud CLI ist im Paketformat zur Installation auf Red Hat Enterprise Linux 7, 8 und 9 sowie auf Fedora 33 und 34 und CentOS 7- und 8-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. Diese können wie unten in diesem Abschnitt separat installiert werden.

Installation

1. Aktualisieren Sie DNF mit Repository-Informationen der gcloud CLI. Der folgende Beispielbefehl bezieht sich auf eine Installation von Red Hat Enterprise Linux 9. Achten Sie jedoch darauf, die Einstellungen nach Bedarf für Ihre Konfiguration zu 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
   

2. Wenn Sie auf Fedora 34 oder 35 installieren, installieren Sie libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installieren Sie die gcloud CLI:

   sudo dnf install google-cloud-cli

Hinweis: Wenn Sie die Migration in dnf auf Ihrem System noch nicht ausgeführt haben, können Sie diese Befehle stattdessen mit yum ausführen.

Sie können auch die Optionen dnf/yum mit den bereitgestellten Befehlen verwenden, wie z. B. das Deaktivieren von Eingabeaufforderungen oder Probeläufen.

4. (Optional) Installieren Sie eine oder mehrere 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

5. 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.

macOS

1. 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 oder python -V aus. Unterstützte Versionen sind Python 3.8 bis 3.12).
   • Das Hauptinstallationsskript bietet die Installation von Python 3.11 von CPython.
   • 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 den CLOUDSDK_PYTHON fest. in Ihrer Shell so, 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.
2. Laden Sie eine der folgenden Dateien herunter:
   Hinweis: Führen Sie uname -m über eine Befehlszeile aus, um den Namen Ihrer Maschinenhardware zu ermitteln.

Plattform	Paket	Größe	SHA256-Prüfsumme
macOS 64-Bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	52,8 MB	d9b947600e67350f86edd28b97bed7b98ab4f5076bea9b9b4b8717284a819d2a
macOS 64-Bit (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	52,7 MB	487296f593a775ebefd12e9f127e9b15244bb2ddca9ad750e0a7e7f29396038e
macOS 32-Bit (x86)	google-cloud-cli-darwin-x86.tar.gz	51,5 MB	f2797a434a7cb4060ca86de2f0a3cda683e70d84bff20b643e90891c4005bfae

1. 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 Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.

2. (Optional) Verwenden Sie das Installationsskript, um die gcloud CLI-Tools Ihrem PATH hinzuzufügen. Sie können auch die Befehlsvervollständigung für Ihre Shell aktivieren, Nutzungsstatistiken erheben und Python 3.11 installieren.

   Führen Sie das Script (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit diesem Befehl aus:

   ./google-cloud-sdk/install.sh
   

   This can also be done non-interactively (for example, using a script) by providing preferences as flags. To describe the available flags, run:

   ./google-cloud-sdk/install.sh --help
   

   To run the install script with screen reader mode on:

   ./google-cloud-sdk/install.sh --screen-reader=true
   

   Open a new terminal so that the changes take effect.
3. To initialize the gcloud CLI, run gcloud init:

./google-cloud-sdk/bin/gcloud init

4. Optional. Install additional components using the component manager.

Windows

The Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.

1. Download the Google Cloud CLI installer.

   Alternatively, open a PowerShell terminal and run the following PowerShell commands:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. 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.

3. Die Google Cloud CLI erfordert Python. Unterstützte Versionen sind Python 3.8 bis 3.12. 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.

4. 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.

5. 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.

Tipps zur Fehlerbehebung:

• Wenn die Installation aufgrund der Nichterkennung des Befehls find fehlschlägt, achten Sie darauf, dass die Umgebungsvariable PATH so eingestellt ist, dass sie den Ordner mit find enthält. Normalerweise ist dies C:\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

Abhängig von Ihren Entwicklungsanforderungen empfohlene Installation, können Sie auch eine alternative Methode zur Installation der gcloud CLI verwenden:

• gcloud CLI mit Skripts oder Continuous Integration/Bereitstellung? Laden Sie ein versioniertes Archiv für nicht interaktive Installation einer bestimmten Version der gcloud CLI.
• Sie möchten die gcloud CLI als Docker-Image ausführen? Verwenden Sie die Methode gcloud CLI Docker-Image für die aktuelle Version Release (oder eine bestimmte Version) der gcloud CLI.
• Sie nutzen Ubuntu und bevorzugen automatische Aktualisierungen? Verwenden Sie Snap-Paket zur Installation der gcloud CLI.
• Für interaktive Windows- und macOS-Installationen und alle anderen Anwendungsfälle Führen Sie das interaktive Installationsprogramm aus, um die Installation durchzuführen. der neuesten Version der gcloud CLI.

Installation verwalten

Nachdem Sie die gcloud CLI installiert haben, können Sie Befehle im Befehl gcloud components Gruppe, um deine Installation zu verwalten. Dieses umfasst das Anzeigen installierter Komponenten, das Hinzufügen und Entfernen von Komponenten sowie oder ein Downgrade auf eine bestimmte Version des gcloud CLI verwenden können.

Hinweis: Wenn Sie zur Installation der gcloud CLI apt-get oder yum verwendet haben, führen Sie Sie müssen zum Aktualisieren oder Entfernen von Komponenten apt-get oder yum verwenden, nicht gcloud components

Frühere Versionen der gcloud CLI

Wenn Sie eine andere Version der gcloud CLI benötigen, installieren Sie die aktuelle Version entsprechend der Anleitung weiter oben auf dieser Seite und melde dich an. Nach der Anmeldung 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.12 erforderlich. Weitere Informationen zur Auswahl und Konfiguration 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