gcloud-CLI installieren

Diese Seite enthält eine Anleitung zur Auswahl und Verwaltung einer Google Cloud CLI-Installation. Die Google Cloud CLI enthält die Befehlszeilentools gcloud, gsutil und bq. Eine Liste der Features 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 gilt für die Installation der Google Cloud CLI. Informationen zum Installieren zusätzlicher Komponenten, z. B. mit gcloud CLI-Befehlen auf der Alpha- oder Betaversion, finden Sie unter gcloud CLI-Komponenten verwalten.

Linux
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3 (3.5 bis 3.9). 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:
    Plattform Paket Größe SHA256-Prüfsumme
    Linux 64-Bit

    (x86_64)

    google-cloud-cli-431.0.0-linux-x86_64.tar.gz 190,7 MB 98f1d8d402acccb09cb0edbfe163ab4869bd79852f7378519784b2f89519c263
    Linux 64-Bit

    (ARM)

    google-cloud-cli-431.0.0-linux-arm.tar.gz 118,7 MB 0346d78bb31ee7d082e735c2205f042b43c70a60e7a20e40b51a5dce28b19fcc
    Linux 32-Bit

    (x86)

    google-cloud-cli-431.0.0-linux-x86.tar.gz 120,0 MB a7de8cf104b2553fa0755c8a893a25bac6e9702779a11b8d93b43d5911cb6070

    Alternativ können Sie so die 64-Bit-Linux-Archivdatei in der Befehlszeile herunterladen:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-431.0.0-linux-x86_64.tar.gz

    Führen Sie für die 64-Bit-Arm-Archivdatei Folgendes aus:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-431.0.0-linux-arm.tar.gz

    Führen Sie für die 32-Bit-Archivdatei Folgendes aus:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-431.0.0-linux-x86.tar.gz
  3. Extrahieren Sie den Inhalt der Datei an einen beliebigen Speicherort in Ihrem Dateisystem (vorzugsweise in Ihrem Basisverzeichnis). 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. Das folgende Beispiel zeigt den Befehl für 32-Bit-Linux. Wenn Sie eine andere Plattform verwenden, passen Sie den Befehl entsprechend an:
    tar -xf google-cloud-cli-431.0.0-linux-x86.tar.gz
  4. Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installations-Skript 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 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:
  7. ./google-cloud-sdk/bin/gcloud init
    
  8. Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Debian/Ubuntu

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:

Installation
  1. Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu. Wenn Ihre Distribution die Option "signed-by" unterstützt, 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

    Wenn Ihre Distribution die Option "signed-by" nicht unterstützt, führen Sie 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
  2. Importieren Sie den öffentlichen Google Cloud-Schlüssel. Wenn der Befehl apt-key Ihrer Distribution das Argument --keyring unterstützt, führen Sie 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 Ihre Distribution (Debian 11+ oder Ubuntu 21.10 oder höher) apt-key nicht unterstützt, führen Sie den folgenden Befehl aus:

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

    Wenn Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle "apt-get.gpg"-Schlüsseldatei ab.

  3. Aktualisieren Sie die gcloud CLI und installieren Sie sie:
    sudo apt-get update && sudo apt-get install google-cloud-cli
    Weitere Optionen für apt-get, z. B. zum Deaktivieren von Aufforderungen oder Probeläufen, findest du auf den apt-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 | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
          
    Wenn der Befehl apt-key nicht unterstützt wird:
    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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -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

Paketinhalt

Die gcloud CLI ist im Paketformat zur Installation auf den Systemen Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, Fedora 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.

Installation
  1. Aktualisieren Sie DNF mit Repository-Informationen der gcloud CLI. Der folgende Beispielbefehl bezieht sich auf eine Installation von Red Hat Enterprise Linux 8. Ersetzen Sie bei einer mit Red Hat Enterprise Linux 7 kompatiblen Installation el8 durch el7 im Wert für baseUrl.
    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-el8-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 libcrypt-compat.x86_64.
    sudo dnf install libxcrypt-compat.x86_64
  3. Installieren Sie die gcloud CLI:
    sudo dnf install google-cloud-cli
  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 (3.5 bis 3.9).
    • Ab Cloud SDK-Version 352.0.0 kann das Hauptinstallationsskript Python 3.7 von CPython auf Intel-basierten Macs installieren.
    • Weitere Informationen zur Auswahl und Konfiguration Ihres Python-Interpreters finden Sie unter gcloud topic startup.
  2. Laden Sie eine der folgenden Optionen herunter:
  3. Plattform Paket Größe SHA256-Prüfsumme
    macOS 64-Bit

    (x86_64)

    google-cloud-cli-431.0.0-darwin-x86_64.tar.gz 125,0 MB 234de320421803784d0717e156db6fa82dc6816e6d625d48721affbac69914ef
    macOS 64-Bit

    (ARM64, Apple M1 silicon)

    google-cloud-cli-431.0.0-darwin-arm.tar.gz 122,1 MB 7e0f9ffbd24d41cb8e98f5bcb007fb47b98d2af461942db53896f4098e57237e
    macOS 32-Bit

    (x86)

    google-cloud-cli-431.0.0-darwin-x86.tar.gz 104,7 MB 4962cbe52bec47bf2759229a7283a8f8372b87bf986267d8eba2dddf9cc3937f
    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 das Archiv an denselben Speicherort.

    2. Optional: Verwenden Sie das Installationsskript, um Ihrer PATH gcloud CLI-Tools hinzuzufügen.Sie können auch die Vervollständigung von Befehlen für Ihre Shell, die Erhebung von Nutzungsstatistiken und die Installation von Python 3.7 aktivieren.

      Führen Sie das Skript mit dem folgenden Befehl im Stammverzeichnis des Ordners aus, den Sie im letzten Schritt extrahiert haben:

      ./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 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.
    3. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Windows
    Die Google Cloud CLI funktioniert auf Windows 8.1 und höher sowie auf Windows Server 2012 und höher.
  1. Laden Sie das Installationsprogramm für die Google Cloud-CLI herunter.

    Öffnen Sie alternativ ein PowerShell-Terminal und führen Sie die folgenden PowerShell-Befehle aus:

    (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. Das Cloud SDK erfordert Python. Unterstützte Versionen sind Python 3 (3.5 bis 3.9). Die Windows-Version des Cloud SDK ist standardmäßig in Python 3 enthalten. Um das Cloud SDK 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. Das Cloud SDK 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 können Sie anstelle der empfohlenen Installation eine alternative Methode zur Installation der gcloud CLI verwenden:

  • Sie verwenden die gcloud CLI mit Skripts oder Continuous Integration/Deployment? Laden Sie ein versioniertes Archiv für eine nicht interaktive Installation einer bestimmten Version der gcloud CLI herunter.
  • Sie müssen die gcloud CLI als Docker-Image ausführen? Verwenden Sie das Docker-Image der gcloud CLI, um den neuesten Release (oder eine bestimmte Version) der gcloud CLI zu verwenden.
  • Sie nutzen Ubuntu und bevorzugen automatische Aktualisierungen? Verwenden Sie ein Snap-Paket, um die gcloud CLI zu installieren.
  • Führen Sie für Windows- und macOS-Installationsinstallationen 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 gcloud componentsBefehle verwenden, um die Installation zu verwalten. Dazu gehören das Aufrufen installierter Komponenten, das Hinzufügen und Entfernen von Komponenten sowie ein Downgrade 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 mithilfe der Anleitung, die weiter oben auf dieser Seite angezeigt wird, und melden Sie sich dann an. Nachdem Sie sich angemeldet haben, können Sie frühere Releases herunterladen. Wenn Sie die Versionen nach Datum sortieren möchten, aktivieren Sie Sortieren und filtern. Klicken Sie dann auf die Spalte Erstellt.

Unterstützte Python-Versionen

Für die Google Cloud CLI ist Python 3 (3.5 bis 3.9) erforderlich. Informationen zur Auswahl und Konfiguration Ihres 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