Google Cloud CLI installieren

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 grundlegende gcloud CLI-Befehle aus, um Informationen zu Ihrer Installation aufzurufen und zu prüfen, ob sie erfolgreich war.

Hinweis

1. 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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

gcloud CLI-Version 589.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.15. 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:
   Hinweis: Führen Sie uname -a in der Befehlszeile aus, um die Linux-Plattform Ihres Betriebssystems zu ermitteln.

   Plattform	Paketname	Größe	SHA256-Prüfsumme
   Linux 64-Bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	93,5 MB	817026aec0adea0e2ee8ed3a1ba3eabfe9e5177581fbe16595a8fe495a601300
   Linux 64-Bit (Arm)	google-cloud-cli-linux-arm.tar.gz	54,1 MB	c7b9abef0649e0fccc70bf2aaaa031a0aa6202863e45fabe938698dc93d4934c
   Linux 32-Bit (x86)	google-cloud-cli-linux-x86.tar.gz	54,1 MB	69f2e18bd0e706a6b31d005381bdf6b17ede01bcf6ce1804a42e2e7cef09bd9c

   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 Installations-Script aus dem Stammverzeichnis des Ordners aus, den Sie extrahiert haben:

   ./google-cloud-sdk/install.sh

   Das Script fordert Sie auf, die folgenden Einrichtungsschritte auszuführen. Wenn Sie die Einladung annehmen möchten, antworten Sie mit Y, wenn Sie dazu aufgefordert werden.
   • Fügen Sie die gcloud CLI zu PATH hinzu.
   • Aktivieren Sie die Befehlsvervollständigung.
   • Stimmen Sie dem Senden anonymer Nutzungsstatistiken zu, um zur Verbesserung der gcloud CLI beizutragen.
   Sie können die Installation auch nicht interaktiv ausfü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 im vorherigen Schritt Ihre PATH 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.

Verfügbarkeit von Paketversionen: Paketversionen, die innerhalb der letzten 365 Tage veröffentlicht wurden, werden im Repository aufbewahrt.

Hinweis: Für bestimmte Konfigurationen sind alternative Installationsmethoden verfügbar:

• Wenn Sie einen modernen Ubuntu-Release mit Snap Package Manager ausführen und automatische Updates wünschen, können Sie die Google Cloud CLI als Snap-Paket installieren.
• Wenn Sie eine Compute Engine-Instanz verwenden, ist die gcloud CLI möglicherweise bereits installiert. Eine Liste der Betriebssystem-Images, die die Befehlszeile standardmäßig enthalten, finden Sie unter Details zu Betriebssystemen.

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 jetzt den folgenden Befehl aus:

  sudo apt-get update

• Darauf 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 öffentlichen Schlüssel Google Cloud .

   • 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

   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 Sie die gcloud CLI und installieren Sie sie:

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

   Hinweis: Wenn Sie die Installation in virtuellen Maschinen, Container-Images oder automatisierten CI/CD-Runnern mit eingeschränkten Ressourcen durchführen, können Sie die Umgebungsvariable CLOUDSDK_SKIP_PY_COMPILATION=1 während der Installation exportieren, um die hostseitige Python-Kompilierung zu überspringen. Dadurch verkürzt sich die Installationszeit von Minuten auf Sekunden:

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli

   Wenn Sie diese Variable festlegen, wird die Byte-Kompilierung bei der Installation übersprungen. Dadurch wird die Paketinstallation etwas beschleunigt, aber die Ausführung interaktiver Befehle wird geringfügig verlangsamt.
   Weitere Optionen für apt-get, wie das Deaktivieren von Prompts oder Probeläufen, 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 | 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-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-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-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

Paketversionen, die in den letzten 365 Tagen veröffentlicht wurden, werden im Repository beibehalten.

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.

Verfügbarkeit von Paketversionen: Paketversionen, die innerhalb der letzten 365 Tage veröffentlicht wurden, werden im Repository aufbewahrt.

Hinweis: Wenn Sie eine Instanz in Compute Engine verwenden, wird die Google Cloud CLI standardmäßig auf einer Reihe von Betriebssystem-Images installiert. Eine vollständige Liste finden Sie unter Betriebssystemdetails.

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 der 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 (kompatibel mit RHEL 7, 8 oder 9) oder https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (kompatibel mit RHEL 10) 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

   Hinweis: Wenn Sie die Installation in virtuellen Maschinen, Container-Images oder automatisierten CI/CD-Runnern mit eingeschränkten Ressourcen durchführen, können Sie die Umgebungsvariable CLOUDSDK_SKIP_PY_COMPILATION=1 während der Installation exportieren, um die hostseitige Python-Kompilierung zu überspringen. Dadurch verkürzt sich die Installationszeit von Minuten auf Sekunden:

   sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli

   Wenn Sie diese Variable festlegen, wird die Byte-Kompilierung bei der Installation übersprungen. Dadurch wird die Einrichtung des Pakets beschleunigt, aber es entsteht ein geringer Overhead bei der Ausführung interaktiver Befehle.
   Hinweis:Wenn Sie die Migration zu 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-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-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-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

   Wenn Sie beispielsweise die Komponente google-cloud-cli-app-engine-java installieren möchten, führen Sie den folgenden Befehl aus:

   sudo dnf 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. Ersetzen Sie 123.0.0 durch die Version, die Sie installieren möchten:

sudo dnf downgrade google-cloud-cli-123.0.0

Paketversionen, die innerhalb der letzten 365 Tage veröffentlicht wurden, werden im Repository aufbewahrt.

macOS

1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.10 bis 3.15.

   Um Ihre Python-Version zu prüfen, führen Sie python3 -V oder python -V aus.

   Das gcloud-Installationsprogramm installiert standardmäßig Python v3.14 und die erforderlichen Erweiterungsmodule.

   Weitere Informationen zum Konfigurieren des Python-Interpreters finden Sie in der gcloud topic startup-Dokumentation.

2. Laden Sie eine der folgenden Dateien herunter:
   Hinweis: Führen Sie uname -m über eine Befehlszeile aus, um Ihre Plattform zu ermitteln.

   Plattform	Paket	Größe	SHA256-Prüfsumme
   macOS 64-Bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	54,3 MB	b49e8cb9d348267d46fade7b9c916a1aed7ce0ec07e142ce41cc0d24a95a9651
   macOS 64-Bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	54,2 MB	71b37ca07ab0f9bc43898e42c913e10f143166230ab31e0bbea3632dbc77b010
   macOS 32-Bit (x86)	google-cloud-cli-darwin-x86.tar.gz	52,6 MB	bc9d328fbf56f650b57d9a70eb267993c98d0a9cbd15864b0b8fee949ea1039f

   Alternativ können Sie das Archiv über die Befehlszeile herunterladen. Ersetzen Sie FILE_NAME durch den Paketnamen für Ihre Plattform aus der Tabelle oben.

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME

3. Extrahieren Sie den Inhalt der Datei an den gewünschten Speicherort in Ihrem Dateisystem. Häufig wird es in das Home-Verzeichnis extrahiert.

   Unter macOS erreichen Sie dies, indem Sie die heruntergeladene Datei .tar.gz am bevorzugten Speicherort öffnen. Alternativ können Sie über die Befehlszeile folgenden Befehl ausführen:

   tar -xf FILE_NAME

   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, den Sie extrahiert haben:

   ./google-cloud-sdk/install.sh

   Das Skript fordert Sie auf, die folgenden Einrichtungsaktionen auszuführen. Wenn Sie die Einladung annehmen möchten, antworten Sie mit Y, wenn Sie dazu aufgefordert werden.
   • Installieren Sie bei Bedarf Python 3.14 und die empfohlenen Module.
   • Fügen Sie die gcloud CLI zu PATH hinzu und aktivieren Sie die Befehlsvervollständigung.
   • Aktivieren Sie die Option zum Senden anonymer Nutzungsstatistiken, um zur Verbesserung der gcloud CLI beizutragen.
   Sie können die Installation auch nicht interaktiv ausführen, indem Sie Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen:

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

5. Optional: Wenn Sie im vorherigen Schritt Ihre PATH aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.

Windows

Für die Google Cloud CLI unter Windows ist Windows 8.1 oder höher bzw. Windows Server 2012 oder höher erforderlich.

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

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.
   • Die Google Cloud CLI erfordert Python. Unterstützte Versionen sind Python 3.10 bis 3.15. 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.

3. Nach Abschluss der Installation haben Sie die Möglichkeit, das Startmenü und die Desktopverknüpfungen zu erstellen und die Google Cloud CLI-Shell zu starten. Entfernen Sie das Häkchen aus der Option zum Starten der Shell. In den nächsten Schritten führen Sie die gcloud CLI aus und konfigurieren sie.

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.

Chromebook

1. Richten Sie die Linux-Entwicklungsumgebung auf Ihrem Chromebook ein.
2. Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu. Führen Sie dazu diesen 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

3. Importieren Sie den öffentlichen Schlüssel von Google Cloud :

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

4. Aktualisieren Sie die gcloud CLI und installieren Sie sie:

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

5. Optional: Installieren Sie eine oder mehrere der folgenden zusätzlichen Komponenten:
   • 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-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-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

   Wenn Sie beispielsweise die Komponente google-cloud-cli-app-engine-java installieren möchten, führen Sie den folgenden Befehl aus:

   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. Ersetzen Sie 123.0.0 durch die Version, die Sie installieren möchten:

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

Paketversionen, die innerhalb der letzten 365 Tage veröffentlicht wurden, werden im Repository aufbewahrt.

gcloud CLI initialisieren und autorisieren

Wenn Sie sich hinter einem Proxy oder einer Firewall befinden, finden Sie unter Proxy-Konfiguration Informationen dazu, wie Sie den Netzwerkzugriff für die gcloud CLI aktivieren.

Nachdem Sie die gcloud CLI installiert haben, initialisieren Sie sie, um den Zugriff auf Google Cloud zu autorisieren und eine Standardkonfiguration einzurichten. Weitere Informationen finden Sie unter: gcloud init

1. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:

   gcloud init
   

   Standardmäßig wird mit diesem Befehl ein Webbrowser geöffnet, um den Zugriff zu autorisieren. Wenn Sie die Autorisierung stattdessen über die Befehlszeile vornehmen möchten, fügen Sie das Flag --console-only hinzu. Für die nicht interaktive Autorisierung erstellen Sie ein Dienstkonto mit den entsprechenden Bereichen in der Google Cloud Console und verwenden dann gcloud auth activate-service-account mit der zugehörigen JSON-Schlüsseldatei.

2. Folgen Sie den Aufforderungen, um Folgendes zu autorisieren und zu konfigurieren:

   • Wenn Sie aufgefordert werden, sich anzumelden, akzeptieren Sie die Aufforderung und melden Sie sich dann in Ihrem Browser in Ihrem Google-Konto an. Klicken Sie auf Zulassen, um die Berechtigung für den Zugriff auf Ressourcen zu erteilen.

   • Wählen Sie aus der Liste der Projekte, für die Sie die Berechtigung Inhaber, Bearbeiter oder Betrachter haben, ein Projekt aus. Wenn Sie nur ein Projekt haben, wird es von gcloud init ausgewählt.

     Wenn Sie mehr als 200 Projekte haben, werden Sie aufgefordert, eine Projekt-ID einzugeben, ein Projekt zu erstellen oder Projekte aufzulisten. Wenn Sie ein Projekt erstellen, müssen Sie auch die Abrechnung dafür aktivieren.

   • Wenn Sie die Compute Engine API aktiviert haben, wählen Sie eine Compute Engine-Standardzone aus.

3. Optional: Aktivieren Sie für eine bessere Screenreader-Nutzung das Attribut accessibility/screen_reader mit dem folgenden Befehl:

   gcloud config set accessibility/screen_reader true
   

   Weitere Informationen finden Sie im Leitfaden Bedienungshilfen aktivieren.

Hauptbefehle ausführen

Führen Sie die folgenden Befehle aus, um Informationen zu Ihrer gcloud CLI-Installation aufzurufen:

1. Listen Sie die Konten auf, deren Anmeldedaten im lokalen System gespeichert sind:

   gcloud auth list
   

   In der gcloud CLI wird eine Liste der Konten mit Anmeldedaten angezeigt:

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  [e-mail]
                      [e-mail]
   

2. Attribute in der aktiven gcloud CLI aufrufen:

   gcloud config list
   

   Die gcloud CLI zeigt die Liste der Attribute an:

   [core]
   account = [e-mail]
   disable_usage_reporting = False
   project = example-project
   

3. Informationen zu gcloud-Befehlen und anderen Themen ansehen:

   gcloud help
   

   So rufen Sie beispielsweise die Hilfe für gcloud compute instances create auf:

   gcloud help compute instances create
   

   Die gcloud CLI zeigt ein Hilfethema mit einer Beschreibung des Befehls, einer Liste mit Befehls-Flags sowie Argumenten und Nutzungsbeispielen an.

Optional: Zusätzliche Komponenten installieren

Informationen zum Installieren zusätzlicher Komponenten wie der App Engine-Emulatoren, kubectl oder gcloud CLI-Befehle auf Alpha- oder Beta-Release-Ebene finden Sie unter gcloud CLI-Komponenten verwalten.

Nächste Schritte

• Eine Übersicht über die gcloud CLI, einschließlich einer kurzen Einführung in die wichtigsten Konzepte, Befehlskonventionen und hilfreiche Tipps, finden Sie im Leitfaden zur gcloud CLI.
• Im Referenzhandbuch zur gcloud CLI finden Sie detaillierte Seiten zu jedem gcloud CLI-Befehl, einschließlich Beschreibungen, Flags und Beispielen, mit denen Sie eine Vielzahl von Aufgaben in Google Cloudausführen können.
• Eine Liste häufig verwendeter Befehle und wichtiger Konzepte finden Sie im gcloud CLI-Spickzettel.