Google Cloud CLI installieren

Bevor Sie der Anleitung in diesem Leitfaden folgen, lesen Sie den Artikel Google Cloud CLI für Cloud de Confianceeinrichten.

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.

Hinweis

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

  2. Verify that billing is enabled for your Cloud de Confiance project.

gcloud CLI-Version 562.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 204,3 MB 38bd4f203392354fa7cc5514ee38ea02bb808aa5f1f7e00257806abf782dde38
    Linux 64-Bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 59,1 MB 4fde7da4176fdc8e88f33a2293a050afada0d72d77686cdcdedeee9e807d69b6
    Linux 32-Bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 59,2 MB 189dffeda176a149f16810a3c80a18dd8c9e0dfa2ae302600ac0c4907f571ec8

    Führen Sie den folgenden Befehl aus, um die Linux-Archivdatei herunterzuladen: 

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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, 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 bei der Eingabeaufforderung 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 die PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
macOS
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.10 bis 3.14.

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

    Das gcloud-Installationsprogramm installiert standardmäßig Python v3.13 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:
    Plattform Paket Größe SHA256-Prüfsumme
    macOS 64-Bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 59,3 MB 9044aee682dcec5551fc58c127d717a6428b4c56f264f3a1c0f2a055c70f44fa
    macOS 64-Bit

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 59,2 MB 9c02c838d31c2c1d0cad449f179874a7033c771c436ce69742e4b2019aff23af
    macOS 32-Bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 57,6 MB 8cb17e640b83492cb9aa99d210ab060a0eb473811a81f6430f64243598b41402

    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://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
  3. Entpacken Sie die Inhalte der Datei an einem beliebigen 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 Anfrage annehmen möchten, antworten Sie bei der Eingabeaufforderung mit Y.
    • Installieren Sie bei Bedarf Python 3.13 und die empfohlenen Module.
    • Fügen Sie die gcloud CLI zu Ihrem 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 die 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://storage.s3nsapis.fr/cloud-sdk-release/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.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.

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 Cloud de Confiance 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 Cloud de Confiance -Konsole 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 Berechtigungen 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
*                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com

  2. Attribute in der aktiven gcloud CLI aufrufen:

    gcloud config list

    Die gcloud CLI zeigt die Liste der Attribute an:

    [core]
account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
disable_usage_reporting = False
project = my-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.

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 Cloud de Confianceausführen können.
  • Im Spickzettel für die gcloud CLI finden Sie eine Liste der häufig verwendeten Befehle und Schlüsselkonzepte.