Google Cloud CLI installieren

In dieser Kurzanleitung wird die empfohlene Methode zum Installieren und Initialisieren der Google Cloud CLI beschrieben. Führen Sie nach der Initialisierung einige wichtige gcloud CLI-Befehle aus, um Informationen zu Ihrer Installation aufzurufen und zu prüfen, ob sie erfolgreich war.

Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:

Anleitung

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie 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.

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

  3. Verify that billing is enabled for your Google Cloud project.

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

  5. Verify that billing is enabled for your Google Cloud project.

gcloud CLI-Version 579.0.0 installieren

Linux
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.10 bis 3.14. Das x86_64-Linux-Paket enthält einen gebündelten Python-Interpreter, der standardmäßig bevorzugt wird. Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie in der gcloud topic startup-Dokumentation.
  2. Laden Sie eine der folgenden Dateien herunter:
    Plattform Paketname Größe SHA256-Prüfsumme
    Linux 64-Bit

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 96,1 MB bd0f7eab135cfe64ca28d4cf1c4af2b20da40c63966f05066a546de41775713e
    Linux 64-Bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61,5 MB 1908a3c9feade59310532d555c02530301ed23f5eca524a6ef4bb6fe55396160
    Linux 32-Bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61,6 MB 6a19488ae14a8211b9d2f677f22cc219df0b51ecb1e2558501e136597d445d3f

    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

    Sehen Sie in der Tabelle oben nach und ersetzen Sie google-cloud-cli-linux-x86_64.tar.gz durch den *.tar.gz-Paketnamen, der für Ihre Konfiguration gilt.

  3. Führen Sie den folgenden Befehl aus, um den Inhalt der Datei in Ihr Dateisystem zu extrahieren: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Wenn Sie eine vorhandene Installation ersetzen möchten, löschen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.
  4. Führen Sie das Installationsskript aus dem Stammverzeichnis des Ordners aus, in den Sie extrahiert haben: 
    ./google-cloud-sdk/install.sh
     Das Skript fordert Sie auf, die folgenden Einrichtungsaktionen auszuführen. Wenn Sie die Anfrage annehmen möchten, antworten Sie mit Y.
    • Fügen Sie die gcloud CLI zu PATH hinzu.
    • Aktivieren Sie die Befehlsvervollständigung.
    • Aktivieren Sie die Option zum Senden von anonymen Nutzungsstatistiken, um zur Verbesserung der gcloud CLI beizutragen.
    Sie können die Installation auch nicht interaktiv durchführen, indem Sie Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen: 
    ./google-cloud-sdk/install.sh --help
  5. Optional: Wenn Sie Ihre PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
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 Befehlszeilentools 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.
  • Die Pakete wurden vor Kurzem aktualisiert. Führen Sie dazu den folgenden Befehl aus: 
    sudo apt-get update
  • Es sind ca-certificates, gnupg und curl installiert. Führen Sie den folgenden Befehl aus, um diese Pakete zu installieren: 
    sudo apt-get install ca-certificates gnupg curl

Installation

  1. Importieren Sie den Google Cloud öffentlichen 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 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 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
  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, wie das Deaktivieren von Eingabeaufforderungen oder Probeläufen, finden Sie 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] 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
    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 können Sie eine oder mehrere der folgenden zusätzlichen Komponenten installieren:
    • 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

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

    sudo apt-get install google-cloud-cli-app-engine-java

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. 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 Red Hat Enterprise Linux 7, 8, 9 und 10 sowie auf Fedora 41 und 42 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 7, 8 oder 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

    • Verwenden Sie für RHEL 10-kompatible Installationen den folgenden Befehl mit dem aktualisierten 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

    • Verwenden Sie für ARM64-Installationen (aarch64) https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (RHEL 7, 8 oder 9-kompatibel) oder https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (RHEL 10-kompatibel) als baseurl-Wert.

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