Cloud SDK installieren

Auf dieser Seite finden Sie eine Anleitung zur Auswahl und Pflege einer Cloud SDK-Installation. Das Cloud SDK enthält die gcloud-, gsutil- und bq-Befehlszeilentools. Eine Liste der Cloud SDK-Funktionen 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 des Cloud SDK. Informationen zum Installieren zusätzlicher Komponenten wie gcloud-Tool-Befehle auf der Alpha- oder Beta-Releasestufe finden Sie unter SDK-Komponenten verwalten.

Linux
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Das Cloud SDK erfordert Python 3 (3.5 bis 3.8, 3.7 empfohlen) und Python 2 (2.7.9 oder höher). 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-sdk-370.0.0-linux-x86_64.tar.gz 92,7 MB 0525cfa2a027da3fde18aeafe9c379c97f7b60b20ce3c97f8976a15982b76f62
    Linux 64-Bit

    (arm)

    google-cloud-sdk-370.0.0-linux-arm.tar.gz 89.6 MB 6f0d65cb3d34306476ad509a29a10c7f8d57a04e26ca4f1fc2c72379b879fdf5
    Linux 32-Bit

    (x86)

    google-cloud-sdk-370.0.0-linux-x86.tar.gz 89,5 MB 4e2475af2027b58604a116886d5070fc389a5314ccf9e15da91cae3ddf0c8c4c

    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-sdk-370.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-sdk-370.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-sdk-370.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 das Archiv an denselben Speicherort.
  4. Wenn Sie anonyme Nutzungsstatistiken senden möchten, um das Cloud SDK zu verbessern, antworten Sie mit Y, wenn Sie dazu aufgefordert werden.
  5. Wenn Sie Cloud SDK-Befehlszeilentools zu PATH hinzufügen und die Befehlsvervollständigung aktivieren möchten, antworten mit Y, wenn Sie dazu aufgefordert werden.
  6. Optional. Fügen Sie dem PATH mithilfe des Installationsskripts Cloud SDK-Tools hinzu. Sie können auch die Vervollständigung von Shell-Befehlen und das Erfassen von Nutzungsstatistiken aktivieren.

    Führen Sie das 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. Diese werden beschrieben in:
    ./google-cloud-sdk/install.sh --help
    
    Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
  7. Führen Sie gcloud init aus, um das SDK zu initialisieren:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Debian/Ubuntu

Paketinhalt

Das Cloud SDK steht im Paketformat zur Installation auf Debian- und Ubuntu-Systemen zur Verfügung. 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

Vergewissern Sie sich vor der Installation des Cloud SDK, dass Ihr Betriebssystem die folgenden Anforderungen erfüllt:

Installation
  1. Fügen Sie den URI der Cloud SDK-Distribution 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 Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle "apt-get.gpg"-Schlüsseldatei ab.

  3. Aktualisieren und installieren Sie das Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Weitere Optionen für apt-get, wie das Deaktivieren von Eingabeaufforderungen oder Probeläufen, finden Sie auf den apt-get-man-Seiten.

    Docker-Tipp: Wenn Sie das Cloud SDK 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-sdk -y
          
  4. Optional können Sie eine oder mehrere der folgenden zusätzlichen Komponenten installieren:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Die Komponente google-cloud-sdk-app-engine-java kann beispielsweise so installiert werden:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. Führen Sie gcloud init aus, um zu beginnen:
    gcloud init

Downgrade auf ältere Versionen von Cloud SDK ausführen

Führen Sie den folgenden Befehl aus, um eine bestimmte Version des Cloud SDK wiederherzustellen, wobei VERSION das Format 123.0.0 hat:

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

Die letzten zehn Releases sind immer im Repository verfügbar.

Red Hat/Fedora/CentOS

Paketinhalt

Das Cloud SDK 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 den Cloud SDK-Repository-Informationen. 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-sdk]
    name=Google Cloud SDK
    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/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. Wenn Sie auf Fedora 35 installieren, installieren Sie libcrypt-compat.x86_64.
    sudo dnf install libxcrypt-compat.x86_64
  3. Installieren Sie das Cloud SDK:
    sudo dnf install google-cloud-sdk
  4. Optional können Sie eine oder mehrere dieser zusätzlichen Komponenten installieren:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Die Komponente google-cloud-sdk-app-engine-java kann beispielsweise so installiert werden:

    sudo dnf install google-cloud-sdk-app-engine-java
  5. Führen Sie gcloud init aus, um zu beginnen:
    gcloud init

Downgrade auf ältere Versionen von Cloud SDK ausführen

Wenn Sie eine bestimmte Version von Cloud SDK wiederherstellen möchten, wobei VERSION das Format 123.0.0 hat, führen Sie Folgendes aus: sudo dnf downgrade google-cloud-sdk-VERSION Die letzten zehn Releases sind immer im Repository verfügbar.

macOS
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben:
    • Unterstützte Versionen sind Python 3 (3.5 bis 3.8, 3.7 empfohlen) und Python 2 (2.7.9 oder höher).
    • Moderne Versionen von macOS enthalten die entsprechende Version von Python, die für das Cloud SDK erforderlich ist. Führen Sie folgenden Befehl aus, um Ihre aktuelle Python-Version zu prüfen: python -V
    • Für die Clou SDK-Release-Version 352.0.0 und höher bietet das Hauptinstallationsskript an, Python 3.7 von CPython auf Intel-basierten Macs zu installieren.
    • Weitere Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.
  2. Laden Sie eine der folgenden Dateien herunter:
  3. Plattform Paket Größe SHA256-Prüfsumme
    macOS 64-Bit

    (x86_64)

    google-cloud-sdk-370.0.0-darwin-x86_64.tar.gz 93,0 MB e08541e2e319457698b9154cd064edc5efa95653f5a84b94a1f2f3d0f87ee196
    macOS 64-Bit

    (arm64, Apple M1 silicon)

    google-cloud-sdk-370.0.0-darwin-arm.tar.gz 92,4 MB 64564808bd06947a164645caab99bae9da90f0c814e6faf2e549512d4ad4dca7
    macOS 32-Bit

    (x86)

    google-cloud-sdk-370.0.0-darwin-x86.tar.gz 97,7 MB ffb7c56611b6ec531676eff7f18c22afde7fe35b969eeec1e6154024db3a92b7

    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. Fügen Sie dem PATH mithilfe des Installationsskripts Cloud SDK-Tools hinzu.

      Sie können auch die Vervollständigung von Shell-Befehlen und das Erfassen von Nutzungsstatistiken aktivieren und Python 3.7 optional installieren.

      Führen Sie das Skript (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit diesem 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.
    3. Führen Sie gcloud init aus, um das SDK zu initialisieren:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Windows
  1. Laden Sie das Cloud SDK-Installationsprogramm 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
        
  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 (bevorzugt; 3.5 bis 3.8) und Python 2 (2.7.9 oder höher). 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, Startmenü- und Desktopverknüpfungen zu erstellen, die Cloud SDK Shell zu starten und das Cloud SDK 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 Cloud SDK-Komponentenmanager 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 das Cloud SDK deinstalliert haben, müssen Sie das System neu starten, bevor Sie Cloud SDK neu installieren.
  • Wenn das Entpacken fehlschlägt, führen Sie das Installationsprogramm als Administrator aus.

Weitere Installationsoptionen

Je nach Ihren Bereitstellungsanforderungen können Sie statt der empfohlenen Installation eine alternative Methode zum Installieren des Cloud SDK verwenden:

  • Sie nutzen Cloud SDK zusammen mit Skripts oder einer kontinuierlichen Einbindung bzw. Bereitstellung? Laden Sie ein versioniertes Archiv für eine nicht interaktive Installation einer bestimmten Version des Cloud SDK herunter.
  • Möchten Sie das Cloud SDK als Docker-Image ausführen? Verwenden Sie das Cloud SDK-Docker-Image für die neueste Version (oder eine bestimmte Version) des Cloud SDK.
  • Sie nutzen Ubuntu und bevorzugen automatische Aktualisierungen? Installieren Sie das Cloud SDK mit einem Snap-Paket.
  • Führen Sie für interaktive Windows- und macOS-Installationen sowie alle anderen Verwendungsfälle das interaktive Installationsprogramm aus, um den neuesten Release von Cloud SDK zu installieren.

Installation verwalten

Nachdem Sie das Cloud SDK installiert haben, können Sie mit den Befehlen der Befehlsgruppe gcloud components Ihre Installation verwalten. Dies umfasst die Anzeige von installierten Komponenten, das Hinzufügen und Entfernen von Komponenten sowie Upgrades auf eine neue Version (oder Downgrades auf eine bestimmte Version) des Cloud SDK.

Ältere Versionen des Cloud SDK

Wenn Sie eine ältere Version von Cloud SDK benötigen, können Sie frühere Releases herunterladen.

Jetzt testen

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