Google Cloud CLI installieren

Google Cloud CLI installieren

In dieser Kurzanleitung werden Sie Schritt für Schritt durch die Installation und Initialisierung der Google Cloud CLI geführt. Außerdem führen Sie einige wichtige gcloud CLI-Befehle aus, um starten zu können.

---

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt in der Google Cloud Console aufzurufen.

Anleitung

---

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

3. Make sure 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.

   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

5. Make sure that billing is enabled for your Google Cloud project.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Neueste Version der gcloud CLI (502.0.0) installieren

Hinweis: Wenn Sie sich hinter einem Proxy bzw. einer Firewall befinden, lesen Sie die Seite Proxyeinstellungen, um weitere Informationen zur Installation zu erhalten.

Linux

1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.8 bis 3.13. 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 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	131,6 MB	beb7c8ef61c46ede9295bf68bfb331fbd158575cc3343db585d37b891c890336
   Linux 64-Bit (Arm)	google-cloud-cli-linux-arm.tar.gz	53,9 MB	44eb95fd169f92c197f88df527c3aa27d5db9aa977c2fa2d28fa1cf506b00c9f
   Linux 32-Bit (x86)	google-cloud-cli-linux-x86.tar.gz	53,9 MB	10303f55226fac633761ae52e1dbcbcaf7c59fe11232f8196e6e361fc38e2e77

   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

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

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

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

   Optional: 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.
4. Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installations-Script 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 Scripts) 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:

./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 einen modernen Ubuntu-Release ausführen, der den Snap Package Manager verwendet, können Sie die Google Cloud CLI als Snap-Paket installieren.
• Wenn Sie eine Instanz in Compute Engine verwenden, wird die gcloud CLI standardmäßig auf einer Reihe von Betriebssystem-Images installiert. Eine vollständige Liste finden Sie unter Betriebssystemdetails.

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

• apt-transport-https und curl sind 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 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

   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 | 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 Compute Engine-Instanz verwenden, ist die Google Cloud CLI standardmäßig auf einer Reihe von Betriebssystem-Images installiert. Eine vollständige Liste finden Sie unter Betriebssystemdetails.

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.13.
   • 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 in Ihrer Shell die Umgebungsvariable CLOUDSDK_PYTHON so fest, dass sie auf den Pfad des 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	53,9 MB	9d1af0d2b5e7c8a30145831b99ce46272fc0aba754d7d23dcd3ede414b9ff75a
macOS 64-Bit (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	53,9 MB	d986d0c6531be038b71218f8e7e666c5b4d18ef580d6a063550406ed07e460f9
macOS 32-Bit (x86)	google-cloud-cli-darwin-x86.tar.gz	52,6 MB	e98b4bf6449b9207ff5c4bd3df12a1b38ffa0f498274b26f2d80cfe7fb124f81

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

   Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Scripts) 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:

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

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

Windows

Die Google Cloud-Befehlszeile funktioniert unter Windows 8.1 und höher sowie Windows Server 2012 und höher.

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.

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

Chromebook

1. Linux-Funktion auf Ihrem Chromebook aktivieren Für die Installation der Google Cloud CLI auf Chromebook ist diese Funktion erforderlich.
2. Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu:

   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 Google Cloud-Schlüssel:

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

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
   • 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

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

Optional: Neueste Cloud-Clientbibliotheken installieren

Sie können Cloud-Clientbibliotheken für unterstützte Sprachen herunterladen.

gcloud CLI initialisieren

Mit dem Befehl gcloud init können Sie mehrere gängige Einrichtungsaufgaben für die gcloud CLI ausführen. Dazu gehört die Autorisierung der gcloud CLI für den Zugriff auf Google Cloud anhand der Anmeldedaten Ihres Nutzerkontos und die Einrichtung der Standardkonfiguration.

1. Initialisieren Sie die gcloud CLI:

   gcloud init
   

   Hinweis: Wenn der Befehl keinen Webbrowser starten soll, verwenden Sie stattdessen gcloud init --console-only. Erstellen Sie für eine nicht interaktive Autorisierung ohne Webbrowser in der Google Cloud Console ein Dienstkonto mit den entsprechenden Bereichen und verwenden Sie gcloud auth activate-service-account mit der entsprechenden JSON-Schlüsseldatei.

2. Akzeptieren Sie die Option, sich mit Ihrem Google-Nutzerkonto anzumelden:

   To continue, you must log in. Would you like to log in (Y/n)? Y
   

3. Melden Sie sich bei entsprechender Aufforderung über den Browser bei Ihrem Google-Nutzerkonto an. Klicken Sie auf Zulassen, um die Berechtigung für den Zugriff auf Google Cloud-Ressourcen zu gewähren.

4. Wählen Sie in der Eingabeaufforderung aus der Liste der Google Cloud-Projekte, für die Sie die Berechtigungen Inhaber, Bearbeiter oder Betrachter haben, ein Projekt aus:

   Pick cloud project to use:
    [1] [my-project-1]
    [2] [my-project-2]
    ...
    Please enter your numeric choice:
   

   Wenn Sie nur ein einziges Projekt haben, wählt gcloud init dieses für Sie aus.

   Wenn Sie Zugriff auf mehr als 200 Projekte haben, werden Sie aufgefordert, eine Projekt-ID einzugeben, ein neues Projekt zu erstellen oder Projekte aufzulisten.

   This account has a lot of projects! Listing them all can take a while.
    [1] Enter a project ID
    [2] Create a new project
    [3] List projects
   Please enter your numeric choice:
   

   Hinweis: Wenn Sie ein Projekt erstellen möchten, müssen Sie für Ihr Projekt auch die Abrechnung für Ihr Projekt aktivieren, um Google Cloud-Dienste zu nutzen.

5. Wenn Sie die Compute Engine API aktiviert haben, können Sie mit gcloud init eine Compute Engine-Standardzone auswählen:

   Which compute zone would you like to use as project default?
    [1] [asia-east1-a]
    [2] [asia-east1-b]
    ...
    [14] Do not use default zone
    Please enter your numeric choice:
   

   gcloud init bestätigt, dass die Einrichtungsschritte erfolgreich abgeschlossen wurden:

   Run `gcloud help config` to learn how to change individual settings
   
   This gcloud configuration is called [default]. You can create additional configurations if you work with multiple accounts and/or projects.
   Run `gcloud topic configurations` to learn more.
   
   Some things to try next:
   
   * Run `gcloud --help` to see the Cloud Platform services you can interact with. And run `gcloud help COMMAND` to get help on any gcloud command.
   * Run `gcloud topic --help` to learn about advanced features of the SDK like arg files and output formatting
   * Run `gcloud cheat-sheet` to see a roster of go-to `gcloud` commands.
   

6. Optional: Wenn Sie die Nutzung des Screenreaders verbessern möchten, aktivieren Sie das Attribut accessibility/screen_reader:

   gcloud config set accessibility/screen_reader true
   

   Weitere Informationen zu den Bedienungshilfen der gcloud CLI finden Sie im Leitfaden Bedienungshilfen aktivieren.

Wichtige Befehle ausführen

Führen Sie die folgenden Befehle aus, um Informationen zur Installation der gcloud CLI aufzurufen:

1. Konten auflisten, deren Anmeldedaten im lokalen System gespeichert sind:

   gcloud auth list
   

   Die gcloud CLI zeigt eine Liste der Konten mit Anmeldedaten an:

   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 zur gcloud CLI und der aktiven Konfiguration aufrufen:

   gcloud info
   

   Die gcloud CLI zeigt eine Zusammenfassung der Informationen zu Ihrer Installation an. Hierzu gehören Informationen zu Ihrem System, zu den installierten Komponenten, zum aktiven Nutzerkonto und aktuellen Projekt sowie zu den Attributen in der aktiven Konfiguration.

4. So rufen Sie Informationen zu gcloud-Befehlen und anderen Themen auf:

   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 und Befehlsargumenten sowie Verwendungsbeispielen an.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Nächste Schritte

• In der Anleitung zur gcloud CLI finden Sie eine Übersicht über die gcloud CLI sowie eine kurze Einführung in wichtige Konzepte, Befehlskonventionen und nützliche Tipps.
• In der Referenz zum gcloud-Befehl erhalten Sie ausführliche Informationen zu jedem gcloud-Befehl, einschließlich Beschreibungen, Flags und Beispielen, mit denen Sie verschiedene Aufgaben in Google Cloud ausführen können.
• Im Spickzettel für die gcloud CLI finden Sie eine Liste der häufig verwendeten Befehle und Schlüsselkonzepte.
• Installieren Sie zusätzliche Komponenten wie die App Engine-Emulatoren oder kubectl mit dem Komponentenmanager der gcloud CLI.