Übersicht über die gcloud CLI

Auf dieser Seite finden Sie eine Übersicht über die Google Cloud CLI sowie die zugehörigen Befehlsmuster und Funktionen.

Was ist die gcloud CLI?

Die Google Cloud CLI ist eine Reihe von Tools zum Erstellen und Verwalten Google Cloud von Ressourcen. Mit diesen Tools lassen sich viele gängige Plattformaufgaben entweder über die Befehlszeile oder in Skripts und anderen Automatisierungen ausführen.

Mit der gcloud CLI können Sie beispielsweise Folgendes erstellen und verwalten:

  • VM-Instanzen und andere Ressourcen von Compute Engine
  • Cloud SQL-Instanzen
  • Google Kubernetes Engine-Cluster
  • Managed Service for Apache Spark-Cluster und -Jobs
  • Verwaltete Zonen und Datensätze von Cloud DNS
  • Cloud Deployment Manager-Bereitstellungen

Sie können die gcloud CLI auch verwenden, um App Engine-Anwendungen bereitzustellen, die Authentifizierung zu verwalten, die lokale Konfiguration anzupassen und andere Aufgaben auszuführen.

gcloud CLI herunterladen und installieren

Die aktuelle Version der gcloud CLI ist 589.0.0.

Wir empfehlen dringend, die aktuelle Version der gcloud CLI zu verwenden. Sie können aber auch ältere Versionen aus dem Downloadarchiv herunterladen und installieren.

Wenn Sie Cloud Shell verwenden, ist die gcloud CLI automatisch verfügbar und muss nicht installiert werden. Andernfalls laden Sie die gcloud CLI herunter und installieren Sie sie. Initialisieren Sie sie anschließend.

Standardmäßig installiert die gcloud CLI Befehle, die auf der Stufe „Allgemeine Verfügbarkeit“ freigegeben sind. Zusätzliche Funktionen sind in den gcloud CLI Komponenten namens alpha, beta und preview verfügbar. Mit diesen Komponenten können Sie die gcloud CLI verwenden, um mit Bigtable, Dataflow und anderen Teilen von Google Cloud zu arbeiten, die noch nicht allgemein verfügbar sind.

Spickzettel für die gcloud CLI

Eine kurze Einführung in die gcloud CLI, eine Liste häufig verwendeter Befehle und Informationen zur Struktur dieser Befehle finden Sie auf dem Spickzettel für die gcloud CLI.

Releasestufen

Die gcloud CLI-Befehle haben die folgenden Releasestufen:

Releasestufe Label Beschreibung
Allgemeine Verfügbarkeit Keines Die Befehle gelten als völlig stabil und stehen für den Einsatz in der Produktion zur Verfügung. Vorabankündigungen zu Änderungen an Befehlen, mit denen die aktuelle Funktionalität verloren geht, finden Sie in den Versionshinweisen.
Vorschau preview Die Befehle befinden sich auf der Vorabversionsstufe und werden verwendet, um Feedback von Kunden zu erhalten. Vorabversionen werden in der Regel öffentlich angekündigt, bieten aber nicht unbedingt die vollständige Funktionspalette. Sie unterliegen keinen SLAs oder Verpflichtungen zum technischen Support. Sofern nicht anderweitig von Google angegeben, sind Vorabversionen nur zur Verwendung in Testumgebungen vorgesehen. Die Vorschauphase dauert durchschnittlich etwa sechs Monate.
Beta beta Die Befehle sind funktional vollständig, können aber noch einige ungelöste Probleme aufweisen. Funktionsgefährdende Änderungen an diesen Befehlen können ohne vorherige Ankündigung vorgenommen werden.
Alpha alpha Die Befehle befinden sich in der frühen Releasephase und können ohne Vorankündigung geändert werden.

Die Komponenten alpha, beta und preview werden bei der Installation der gcloud CLI nicht standardmäßig installiert. Sie müssen diese Komponenten installieren separat mit dem Befehl gcloud components install installieren. Wenn Sie versuchen, einen Alpha-, Beta- oder Vorschau-Befehl auszuführen und die entsprechende Komponente nicht installiert ist, werden Sie von der gcloud CLI aufgefordert, sie zu installieren.

Befehlsgruppen

Innerhalb jeder Releasestufe sind die gcloud CLI-Befehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, die jeweils ein Produkt oder Feature von Google Cloud oder seine funktionalen Untergruppen darstellen.

Beispiel:

Befehlsgruppe Beschreibung
gcloud compute Befehle für Compute Engine, die auf der Stufe "Allgemeine Verfügbarkeit" freigegeben sind
gcloud compute instances Befehle für Compute Engine-Instanzen, die auf der Stufe "Allgemeine Verfügbarkeit" freigegeben sind
gcloud beta compute Befehle für Compute Engine in der Betaphase
gcloud preview Befehle für Google Cloud in der Vorschauphase
gcloud alpha app Befehle für die Verwaltung von App Engine-Bereitstellungen in der Alphaphase

gcloud CLI-Befehle ausführen

Sie können gcloud CLI-Befehle über die Befehlszeile sowie über Skripts und andere Automatisierungen ausführen, z. B. wenn Sie Jenkins zum Automatisieren von Google Cloud Aufgaben verwenden.

Attribute

Die gcloud CLI-Attribute sind Einstellungen, die sich auf das Verhalten der gcloud CLI-Tools auswirken. Einige dieser Attribute können entweder über globale Optionen oder über Befehlsoptionen festgelegt werden. In diesem Fall hat der durch die Option festgelegte Wert Vorrang.

Bedienungshilfen aktivieren

Für eine optimierte Nutzung von Screenreadern bietet die gcloud CLI das Attribut accessibility/screen_reader.

Führen Sie den folgenden Befehl aus, um das Attribut für Bedienungshilfen zu aktivieren:

gcloud config set accessibility/screen_reader true

Weitere Informationen zu den Bedienungshilfen des gcloud Befehlszeilentools finden Sie im Handbuch zum Aktivieren von Bedienungshilfen.

Konfigurationen

Eine Konfiguration ist eine Reihe von gcloud CLI-Attributen. Eine Konfiguration funktioniert wie ein Profil.

Wenn Sie die gcloud CLI zum ersten Mal verwenden, arbeiten Sie mit einer einzelnen Konfiguration namens default. Sie können Attribute festlegen, indem Sie gcloud init oder gcloud config set ausführen. Diese eine Standardkonfiguration ist für die meisten Anwendungsfälle geeignet.

Um mit mehreren Projekten oder Autorisierungskonten zu arbeiten, können Sie mit gcloud config configurations create mehrere Konfigurationen einrichten und zwischen den Konfigurationen wechseln. Innerhalb einer Konfiguration können Sie Attribute individuell anpassen. Um Ihr Projekt beispielsweise in einer aktiven Konfiguration festzulegen, verwenden Sie das Attribut project:

gcloud config set project <project-id>

Ausführliche Beschreibungen zu diesen Konzepten finden Sie im Konfigurationsleitfaden.

Globale Optionen

Die gcloud CLI bietet eine Reihe von gcloud CLI-Optionen , die das Verhalten von Befehlen auf Aufrufebene steuern. Optionen überschreiben Werte, die in gcloud CLI-Attributen festgelegt wurden.

Positionelle Argumente und Optionen

Positionelle Argumente und Optionen wirken sich auf die Ausgabe eines gcloud CLI-Befehls aus, es gibt jedoch einen subtilen Unterschied in ihren Anwendungsfällen. Ein positionelles Argument wird verwendet, um eine Entität zu definieren, auf die ein Befehl angewendet wird. Eine Option ist erforderlich, um eine Variation im Verhalten eines Befehls festzulegen.

Verwendung von stdout und stderr

Die Ausgabe erfolgreicher gcloud CLI-Befehle wird in stdout geschrieben. Alle anderen Arten von Antworten – Eingabeaufforderungen, Warnungen und Fehler – werden in stderr geschrieben. Erstellen Sie keine Skripts für Antworten, die in stderr geschrieben werden, da diese Antworten nicht stabil sind.

Richtlinien zur Verarbeitung der Ausgabe finden Sie im Leitfaden für Skripts.

Prompting

Um unbeabsichtigte destruktive Aktionen zu verhindern, bestätigt die gcloud CLI Ihre Absichten, bevor Befehle wie gcloud projects delete ausgeführt werden.

Möglicherweise werden Sie aufgefordert, zusätzliche Informationen anzugeben. Sie werden beispielsweise aufgefordert, eine Zone auszuwählen, wenn Sie mit gcloud compute instances create test-instance eine VM-Instanz von Compute Engine erstellen.

Verwenden Sie die Option --quiet, um die Eingabeaufforderungen zu deaktivieren.

Erstellen Sie keine Skripts für den Wortlaut von Eingabeaufforderungen, da sich der Wortlaut ändern kann.

Unterdrücken von Prompts, Schreiben in das Terminal und Logging

Die --quiet Option (auch -q) für die gcloud CLI deaktiviert alle interaktiven Eingabeaufforderungen beim Ausführen von gcloud CLI-Befehlen und ist nützlich für Skripts. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn keine Standardeinstellung vorhanden ist, wird ein Fehler ausgelöst.

Verwenden Sie die Option --no-user-output-enabled, um die Befehlsausgabe in der Standardausgabe und der Standardfehlerausgabe im Terminal zu unterdrücken.

Verwenden Sie die Option --verbosity, um die Ausführlichkeit der Logs anzupassen. Geben Sie dazu eine Ausführlichkeitsstufe an (debug, info, warning, error, critical oder none).

Ausgabestruktur bestimmen

Wenn ein gcloud CLI-Befehl eine Liste von Ressourcen zurückgibt, werden die Ressourcen standardmäßig in der Standardausgabe formatiert ausgegeben. Mit den Optionen format, filter und projection können Sie die Ausgabe optimieren, um aussagekräftigere Ergebnisse zu erhalten.

Verwenden Sie die --format Option, um nur das Format der Ausgabe zu definieren. So können Sie eine tabellarische oder vereinfachte Version der Ausgabe (für die interaktive Anzeige) oder eine maschinenlesbare Version der Ausgabe (json, csv, yaml, value) erstellen.

Mithilfe von projections können Sie eine Liste der Schlüssel zum Auswählen von Ressourcendatenwerten formatieren. Verwenden Sie filter, um die Ausgabe weiter an die von Ihnen definierten Kriterien anzupassen.

Wenn Sie sich mit den Filter- und Formatierungsfunktionen vertraut machen möchten, können Sie eine kurze interaktive Anleitung durcharbeiten. Klicken Sie dazu auf In Cloud Shell öffnen.

In Cloud Shell öffnen

Nächste Schritte