gcloud CLI initialisieren

Auf dieser Seite erfahren Sie, wie Sie die gcloud CLI initialisieren.

Führen Sie nach der Installation der gcloud CLI die ersten Einrichtungsaufgaben mit gcloud init aus. Sie können auch gcloud init ausführen, um Ihre Einstellungen zu ändern oder eine neue Konfiguration zu erstellen.

gcloud init führt die folgenden Einrichtungsschritte aus:

  • Autorisiert die gcloud CLI für den Zugriff auf Google Cloud anhand der Anmeldedaten Ihres Nutzerkontos. Wurde der Zugriff bereits autorisiert, können Sie ein Konto auswählen.
  • Hiermit wird eine gcloud CLI-Konfiguration eingerichtet und eine Reihe grundlegender Attribute festgelegt, darunter das aktive Konto aus dem vorherigen Schritt, das aktuelle Projekt und gegebenenfalls die Standardregion und -zone von Google Compute Engine.

Sie können alternativ zu gcloud init Folgendes ausführen:

Befehl Beschreibung
gcloud auth login Führt die Autorisierung mit einem Nutzerkonto durch, ohne eine Konfiguration einzurichten.
gcloud auth activate-service-account Führt die Autorisierung mit einem Dienstkonto anstelle eines Nutzerkontos aus.
Nützlich für die nicht interaktive Autorisierung ohne Webbrowser.
gcloud config [COMMAND]
gcloud config configurations [COMMAND] 		Erstellt und verwaltet gcloud CLI-Konfigurationen und -Attribute.

gcloud CLI initialisieren

So initialisieren Sie die gcloud CLI:

  1. Führen Sie gcloud init aus.

    gcloud init

    Wenn Sie sich in einer Remote-Terminalsitzung befinden, können Sie das Flag --no-launch-browser verwenden, um zu verhindern, dass der Befehl bei Bedarf einen browserbasierten Autorisierungsablauf startet:

    gcloud init --no-launch-browser

  2. Erstellen Sie eine Konfiguration oder wählen Sie bei entsprechender Aufforderung eine Konfiguration aus.

    Wenn Sie eine neue gcloud-Befehlszeileninstallation initialisieren, erstellt gcloud init eine neue Konfiguration namens default und legt sie als aktive Konfiguration fest. Sind bereits Konfigurationen vorhanden, bietet Ihnen gcloud init zwei Auswahlmöglichkeiten: Entweder Sie initialisieren die aktive Konfiguration neu, wechseln zu einer anderen Konfiguration und initialisieren diese neu oder Sie erstellen eine neue Konfiguration.

  3. Schließen Sie den Autorisierungsschritt bei entsprechender Aufforderung ab.

    Je nachdem, ob Sie den Zugriff auf Google Cloud bereits autorisiert haben, werden Sie entweder aufgefordert, sich über einen Webbrowser anzumelden und den Zugriff zu gewähren oder ein vorhandenes Konto auszuwählen.

    Wenn Sie das Flag --no-launch-browser verwendet haben und eine Anmeldung erforderlich ist, kopieren Sie die bereitgestellte Autorisierungs-URL und fügen Sie sie in ein anderes Browserfenster ein. Folgen Sie dann den Anweisungen.

    Wenn dieser Schritt abgeschlossen ist, setzt gcloud init das Attribut account in der Konfiguration auf das angegebene Konto.

  4. Wählen Sie bei entsprechender Aufforderung ein aktuelles Google Cloud-Projekt aus.

    Wenn Sie nur auf ein einziges Projekt (einschließlich des Standardprojekts Ihres Nutzerkontos) Zugriff haben, wählt gcloud init dieses für Sie aus.

    Andernfalls können Sie aus der Projektliste, für die Sie die Berechtigung Inhaber, Bearbeiter oder Betrachter haben, ein Projekt auswählen. Mit gcloud init wird daraufhin in der Konfiguration für das Attribut project das von Ihnen ausgewählte Attribut festgelegt. 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. Wählen Sie bei entsprechender Aufforderung eine Compute Engine-Standardzone aus.

    Wenn Sie die Compute Engine API nicht aktiviert haben oder in den Metadaten auf Projektebene bereits eine Standardzone festgelegt ist, wird dieser Schritt nicht angezeigt. Mit gcloud init werden dann die Attribute region und zone der Konfiguration entsprechend der ausgewählten Zone festgelegt

Verwenden Sie den Befehl gcloud config list, um die über den Befehl gcloud init festgelegten Eigenschaften aufzurufen.

[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project

Nächste Schritte