Cloud SDK initialisieren

Auf dieser Seite erfahren Sie, wie Sie das Google Cloud SDK initialisieren.

Nach der Installation des Cloud SDK wird normalerweise der Befehl gcloud init ausgeführt, um die Ersteinrichtung vorzunehmen. Sie können gcloud init auch zu einem späteren Zeitpunkt ausführen, um Ihre Einstellungen zu ändern oder eine neue Konfiguration zu erstellen.

gcloud init führt folgende Einrichtungsschritte aus:

• Autorisierung der Cloud SDK-Tools für den Zugriff auf die Google Cloud Platform anhand der Anmeldedaten Ihres Nutzerkontos. Wurde der Zugriff bereits autorisiert, können Sie ein Konto auswählen.
• Einrichten einer Cloud SDK-Konfiguration und Festlegen grundlegender Attribute, z. B. für das aktive Konto aus dem oben aufgeführten Schritt, das aktuelle Projekt und gegebenenfalls die Standardregion und -zone von Google Compute Engine.

Statt gcloud init können Sie auch folgende Befehle 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 Cloud SDK-Konfigurationen und -Attribute.

"gcloud init" ausführen

So initialisieren Sie das Cloud SDK:

1. Führen Sie gcloud init aus:

   gcloud init
   

   Wenn Sie mit einem Remoteterminal arbeiten, können Sie bei Bedarf mit dem Flag --console-only verhindern, dass der Befehl einen browserbasierten Autorisierungsvorgang startet:

   gcloud init --console-only
   

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

   Wenn Sie eine Cloud SDK-Erstinstallation initialisieren, erstellt gcloud init eine neue Konfiguration namens default und legt sie als aktive Konfiguration fest. Wenn Sie bereits über Konfigurationen verfügen, werden Sie von gcloud init zur Auswahl einer von drei Optionen aufgefordert: Sie können die aktive Konfiguration noch einmal initialisieren, zu einer anderen Konfiguration wechseln und diese noch einmal initialisieren oder eine neue Konfiguration erstellen.

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

   Je nachdem, ob Sie den Zugriff auf die Cloud Platform 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 --console-only 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.

   Nach diesem Schritt legt gcloud init in der Konfiguration das angegebene Konto als Wert für das Attribut account fest.

4. Wählen Sie bei entsprechender Aufforderung ein aktuelles Cloud Platform-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.

5. Wählen Sie bei entsprechender Aufforderung eine Google 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.

Nach dem Abschluss von gcloud init werden die Attribute der aktiven Konfiguration im Terminal ausgegeben:

[compute]
region = us-east1
zone = us-east1-b
[core]
account = [e-mail]
disable_usage_reporting = False
project = example-project

Sie können diese Attribute jederzeit mit dem Befehl gcloud config list auflisten lassen.

Nächste Schritte

• Lesen Sie sich Cloud SDK-Tools autorisieren durch, um mehr über die Autorisierung von Tools zu erfahren.
• Weitere Informationen zu Konfigurationen finden Sie unter Cloud SDK-Konfigurationen.
• Lesen Sie sich Cloud SDK-Attribute durch, um mehr über deren Konfigurationen zu erfahren.