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.

Lesen Sie Google Cloud CLI für Trusted Cloudeinrichten, bevor Sie den Anleitungen in diesem Dokument folgen.

Hinweise

  1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Make sure that billing is enabled for your Trusted Cloud project.

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

Installation der neuesten gcloud CLI-Version (530.0.0)

Linux
  1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.9 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:
    Plattform Paketname Größe SHA256-Prüfsumme
    Linux 64-Bit

    (x86_64)

    google-cloud-cli-linux-x86_64.tar.gz 149,7 MB 1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
    Linux 64-Bit

    (Arm)

    google-cloud-cli-linux-arm.tar.gz 56,3 MB e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
    Linux 32-Bit

    (x86)

    google-cloud-cli-linux-x86.tar.gz 56,3 MB 09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

    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 (vorzugsweise in Ihr Basisverzeichnis):
    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. (Optional) Fügen Sie die gcloud CLI Ihrem PATH hinzu. Sie können auch die Vervollständigung von Shell-Befehlen und das Erfassen von Nutzungsstatistiken aktivieren. Führen Sie das Installationsskript (im Stammverzeichnis des Ordners, den Sie im letzten Schritt 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
    • 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. Wenn Sie die PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
  6. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:
  7. ./google-cloud-sdk/bin/gcloud init
  8. Optional: Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
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.9 bis 3.13.
    • Das Hauptinstallationsskript bietet die Installation von Python 3.12 von CPython.
      • Die Xcode-Befehlszeilentools sind für die Installation von Python erforderlich.
      • Prüfen Sie mit dem Befehl xcode-select -p, ob die Xcode-Befehlszeilentools installiert sind.
      • Wenn die Xcode-Befehlszeilentools nicht installiert sind, installieren Sie sie mit dem Befehl sudo xcode-select --install.
    • 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 die Umgebungsvariable CLOUDSDK_PYTHON in Ihrer Shell 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:
  3. Plattform Paket Größe SHA256-Prüfsumme
    macOS 64-Bit

    (x86_64)

    google-cloud-cli-darwin-x86_64.tar.gz 56,4 MB 0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
    macOS 64-Bit

    (ARM64, Apple silicon)

    google-cloud-cli-darwin-arm.tar.gz 56,4 MB 80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
    macOS 32-Bit

    (x86)

    google-cloud-cli-darwin-x86.tar.gz 54,9 MB 53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a
  4. 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. Oder führen Sie den folgenden Befehl aus:
    tar -xf google-cloud-cli-darwin-arm.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.

  5. Führen Sie das Installationsskript (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit dem folgenden Befehl aus:
    ./google-cloud-sdk/install.sh

    Das Skript fordert Sie auf, Python 3.12 und bestimmte empfohlene Module zu installieren.

    Die Installation kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Skripts), 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
    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.
  6. Wenn Sie die PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
  7. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:
  8. ./google-cloud-sdk/bin/gcloud init
  9. 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://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.

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

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 gcloud CLI für den Zugriff auf Trusted Cloud mit den Anmeldedaten Ihres Nutzerkontos zu autorisieren und die Standardkonfiguration einzurichten.

  1. Initialisieren Sie die gcloud CLI:

    gcloud init
    
  2. Stimmen Sie der Anmeldung mit Ihrem Google-Nutzerkonto zu:

    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 Trusted Cloud -Ressourcen zu gewähren.

  4. Wählen Sie in der Eingabeaufforderung aus der Liste der Projekte, für die Sie die Berechtigungen Inhaber, Bearbeiter oder Betrachter haben, ein Trusted Cloud 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:
    
  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 Screenreader-Funktion 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 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@gmail.com
                       example-user-2@gmail.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@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. Informationen zur gcloud CLI-Installation und zur 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. 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.

Bereinigen

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

  1. In the Trusted 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 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 Referenzleitfaden 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 Trusted Cloudausfü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.