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

    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.

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

    gcloud CLI-Version 548.0.0 installieren

    Linux
    1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.9 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 202,9 MB 71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a
      Linux 64-Bit

      (Arm)

      		 google-cloud-cli-linux-arm.tar.gz 57,7 MB 001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3
      Linux 32-Bit

      (x86)

      		 google-cloud-cli-linux-x86.tar.gz 57,8 MB 921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc

      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 Paketnamen *.tar.gz, 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, 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-Befehlszeile 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 apt-transport-https, ca-certificates, gnupg und curl installiert. Führen Sie den folgenden Befehl aus, um diese Pakete zu installieren: 
      sudo apt-get install apt-transport-https 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 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 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-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

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

      Führen Sie beispielsweise den folgenden Befehl aus, um die Komponente google-cloud-cli-app-engine-java zu installieren: 

      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

    Die zehn neuesten Releases sind im Repository verfügbar. Bei Versionen vor 371.0.0 verwenden Sie google-cloud-sdk als Paketnamen.

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

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

      Das Installationsskript kann Python bei Bedarf für Sie installieren. Dazu sind die Xcode-Befehlszeilentools erforderlich. Führen Sie sudo xcode-select --install aus, um sie zu installieren. Alternativ können Sie eine unterstützte Python-Version von python.org installieren.

      Weitere Informationen zum Konfigurieren des Python-Interpreters, insbesondere wenn Sie mehrere Versionen installiert haben, finden Sie in der gcloud topic startup-Dokumentation.

    2. Laden Sie eine der folgenden Dateien herunter:
      Plattform Paket Größe SHA256-Prüfsumme
      macOS 64-Bit

      (x86_64)

      		 google-cloud-cli-darwin-x86_64.tar.gz 57,9 MB 6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8
      macOS 64-Bit

      (ARM64, Apple silicon)

      		 google-cloud-cli-darwin-arm.tar.gz 57,8 MB 36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339
      macOS 32-Bit

      (x86)

      		 google-cloud-cli-darwin-x86.tar.gz 56,3 MB eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56

      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. Entpacken Sie die Inhalte der Datei an einem beliebigen Speicherort in Ihrem Dateisystem. Häufig wird sie 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 Anfrage annehmen möchten, antworten Sie mit Y.
      • Installieren Sie bei Bedarf Python 3.13 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 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
       So führen Sie das Installationsskript mit aktiviertem Screenreader-Modus aus: 
      ./google-cloud-sdk/install.sh --screen-reader=true
    5. Optional: Wenn Sie Ihre PATH im vorherigen Schritt 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.9 bis 3.14. 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. Deaktivieren Sie die 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. Linux-Entwicklungsumgebung auf einem Chromebook einrichten
    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 Google Cloud öffentlichen 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 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-validator
      • google-cloud-cli-tests
      • kubectl

      Führen Sie beispielsweise den folgenden Befehl aus, um die Komponente google-cloud-cli-app-engine-java zu installieren: 

      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

    Die zehn neuesten Releases sind im Repository verfügbar. Bei Versionen vor 371.0.0 verwenden Sie google-cloud-sdk als Paketnamen.

    gcloud CLI initialisieren und autorisieren

    Wenn Sie sich hinter einem Proxy oder einer Firewall befinden, lesen Sie den Abschnitt Proxykonfiguration, um den Netzwerkzugriff für die gcloud CLI zu 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. Erstellen Sie für die nicht interaktive Autorisierung in der Google Cloud console ein Dienstkonto mit den entsprechenden Bereichen und verwenden Sie dann gcloud auth activate-service-account mit der zugehörigen JSON-Schlüsseldatei.

    2. Folgen Sie der Anleitung, um die folgenden Elemente 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, wählt gcloud init dieses für Sie aus.

        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öchten, 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: Wenn Sie einen optimierten Screenreader benötigen, können Sie das Attribut accessibility/screen_reader mit dem folgenden Befehl aktivieren:

      gcloud config set accessibility/screen_reader true

      Weitere Informationen finden Sie im Leitfaden Bedienungshilfen aktivieren.

    Hauptbefehle ausführen

    Führen Sie die folgenden Kernbefehle aus, um Informationen zu Ihrer gcloud CLI-Installation 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
*                  example-user-1@example.com
                   example-user-2@example.com

    2. Attribute in der aktiven gcloud CLI aufrufen:

      gcloud config list

      Die gcloud CLI zeigt die Liste der Attribute an:

      [core]
account = example-user-1@example.com
disable_usage_reporting = False
project = example-project

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

      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 Beispielen für die Verwendung des Befehls an.

    Optional: Zusätzliche Komponenten installieren

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

    Bereinigen

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

    Nächste Schritte

    • In der gcloud CLI-Anleitung finden Sie eine Übersicht über die gcloud CLI sowie eine kurze Einführung in wichtige Konzepte, Befehlskonventionen und nützliche Tipps.
    • Im Referenzhandbuch für die gcloud CLI finden Sie ausführliche Informationen zu jedem gcloud CLI-Befehl, einschließlich Beschreibungen, Flags und Beispielen, mit denen Sie verschiedene Aufgaben in Google Cloudausführen können.
    • Im Spickzettel für die gcloud CLI finden Sie eine Liste der häufig verwendeten Befehle und Schlüsselkonzepte.