Diese Seite enthält eine Übersicht über das Google Cloud CLI und seine allgemeinen Befehlsmuster und -funktionen.
Was ist die gcloud CLI?
Die Google Cloud CLI ist eine Reihe von Tools zum Erstellen und Verwalten vonGoogle Cloud -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
- Dataproc-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 gcloud CLI-Version ist 530.0.0.
Wir empfehlen dringend, die aktuelle Version der gcloud CLI zu verwenden. Sie können aber auch frühere Versionen aus dem Downloadarchiv herunterladen und installieren.
Wenn Sie Cloud Shell verwenden, ist die gcloud CLI automatisch verfügbar und Sie müssen sie nicht installieren. Andernfalls laden Sie die gcloud CLI herunter und installieren Sie sie und initialisieren Sie sie.
Standardmäßig installiert die gcloud CLI Befehle auf der Stufe „Allgemeine Verfügbarkeit“. Die gcloud CLI-Komponenten alpha und beta bieten zusätzliche Funktionalität. Mit ihnen können Sie die gcloud CLI verwenden, um mit Bigtable, Dataflow und anderen Teilen von Google Cloud zu arbeiten, die noch nicht auf der Stufe „Allgemeine Verfügbarkeit“ sind.
Der Spickzettel für die gcloud CLI
Eine kurze Einführung in die gcloud CLI, eine Liste häufig verwendeter Befehle und die Struktur dieser Befehle finden Sie im Spickzettel für die gcloud CLI.
Releasestufen
Die gcloud-Befehlszeilenbefehle 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. |
| 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 und beta werden bei der Installation der gcloud CLI nicht standardmäßig installiert. Mit dem Befehl gcloud components install müssen Sie diese Komponenten separat installieren. Wenn Sie versuchen, einen Alpha- oder Betabefehl auszuführen und die entsprechende Komponente nicht installiert ist, werden Sie von der gcloud CLI aufgefordert, sie zu installieren.
Befehlsgruppen
Innerhalb jeder Releasestufe sind gcloud CLI-Befehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, von denen jede ein Produkt oder eine Funktion von Google Cloud oder ihren funktionalen Untergruppen darstellt.
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 alpha app |
Befehle für die Verwaltung von App Engine-Bereitstellungen in der Alphaphase |
gcloud-Befehlszeilenbefehle ausführen
Sie können gcloud-Befehlszeilenbefehle über die Befehlszeile und über Skripts und andere Automatisierungsmethoden ausführen, beispielsweise wenn Sie Jenkins zur Automatisierung von Google Cloud Aufgaben verwenden.
Eigenschaften
Die Attribute der gcloud-Befehlszeile sind Einstellungen, die die Funktionsweise der gcloud-Befehlszeilentools steuern. Manche dieser Attribute können global oder mit Befehlsoptionen festgelegt werden. In diesem Fall hat der durch die Option festgelegte Wert Vorrang.
Bedienungshilfen aktivieren
Wenn Sie einen optimierten Screenreader benötigen, können Sie das Attribut accessibility/screen_reader in der gcloud CLI verwenden.
Führen Sie 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 Attributen der gcloud CLI. Eine Konfiguration funktioniert wie ein Profil.
Wenn Sie die gcloud CLI verwenden, arbeiten Sie mit einer einzelnen Konfiguration namens default und 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-Befehlszeilenoptionen, die das Verhalten von Befehlen auf Aufrufebene steuern. Optionen überschreiben alle Werte, die in gcloud CLI-Attributen festgelegt sind.
Positionsargumente und Optionen
Sowohl Positionsargumente als auch Optionen wirken sich auf die Ausgabe eines gcloud CLI-Befehls aus. Es gibt aber einen feinen Unterschied in ihren Anwendungsfällen. Mit einem Positionsargument wird die Entität definiert, auf die ein Befehl angewendet wird, während eine Option erforderlich ist, um eine andere Funktionsweise des Befehls festzulegen.
Verwendung von stdout und stderr
Die Ausgabe von erfolgreichen gcloud-Befehlszeilenbefehlen wird in stdout geschrieben. Alle anderen Arten von Antworten – Aufforderungen, Warnungen und Fehler – werden in stderr geschrieben. Erstellen Sie kein Skript für Antworten, die in stderr geschrieben werden, da diese Antworten nicht stabil sind.
Richtlinien zum Umgang mit Ausgaben finden Sie im Skript-Leitfaden.
Aufforderungen
Zum Schutz vor unbeabsichtigten, folgenschweren Aktionen fordert die gcloud CLI Sie zur Bestätigung Ihrer Absichten auf, bevor Befehle wie gcloud projects delete ausgeführt werden.
Möglicherweise werden Sie aufgefordert, zusätzliche Informationen anzugeben.
Wenn Sie beispielsweise mit gcloud compute instances create test-instance eine VM-Instanz für Compute Engine erstellen, werden Sie aufgefordert, eine Zone auszuwählen.
Verwenden Sie die Option --quiet, um Aufforderungen zu deaktivieren.
Erstellen Sie kein Skript für die Formulierung von Eingabeaufforderungen, da sich diese ändern kann.
Aufforderungen verhindern, in das Terminal schreiben und Logging
Die Option --quiet (auch -q) deaktiviert für die gcloud CLI alle interaktiven Eingabeaufforderungen beim Ausführen von gcloud CLI-Befehlen und ist für Skripts nützlich. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn keine Standardeinstellung vorhanden ist, wird ein Fehler ausgegeben.
Mithilfe der Option --no-user-output-enabled kann im Terminal die Anzeige der Befehlsausgabe in der Standardausgabe und Standardfehlerausgabe unterdrückt werden.
Um die Ausführlichkeit von Logs anzupassen, geben Sie mit der Option --verbosity eine Ausführlichkeitsstufe an (Debug, Info, Warnung, Fehler, kritisch oder keine).
Ausgabestruktur bestimmen
Wenn ein gcloud-Befehlszeilenbefehl eine Liste von Ressourcen zurückgibt, werden diese standardmäßig in Quelltextformatierung an die Standardausgabe gesendet. Zum Optimieren der Ausgabe können Sie die Optionen format, filter und projection verwenden, damit die Ausgabe sinnvoller ist.
Wenn Sie nur das Format Ihrer Ausgabe definieren möchten, erstellen Sie mit der Option --format eine tabellarische bzw. vereinfachte Version der Ausgabe (für eine interaktive Anzeige) oder eine maschinenlesbare Version der Ausgabe (json, csv, yaml, value).
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.
Nächste Schritte
- Weitere Informationen zu gcloud CLI-Befehlen finden Sie in der Referenz zur gcloud CLI.