Diese Seite bietet einen Überblick über die Google Cloud CLI und ihre gängigen Befehlsmuster und Funktionen.
Was ist die gcloud CLI?
Die Google Cloud CLI enthält eine Reihe von Tools zum Erstellen und Verwalten von Google Cloud-Ressourcen. Mit diesen Tools können Sie viele gängige Plattformaufgaben über die Befehlszeile oder über Skripts und andere Automatisierungsaufgaben 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 auch die gcloud CLI verwenden, um App Engine-Anwendungen bereitzustellen, die Authentifizierung zu verwalten, die lokale Konfiguration anzupassen und andere Aufgaben auszuführen.
Die gcloud CLI auf einen Blick
Eine kurze Einführung in die gcloud CLI, eine Liste häufig verwendeter Befehle und eine Beschreibung der Struktur dieser Befehle finden Sie auf dem Leitfaden zur gcloud CLI.
gcloud CLI herunterladen und installieren
Wenn Sie Cloud Shell verwenden, ist die gcloud CLI automatisch verfügbar und Sie müssen sie nicht installieren. Andernfalls können Sie die gcloud-Befehlszeile herunterladen, installieren und dann initialisieren.
Standardmäßig installiert die gcloud CLI Befehle auf der Ebene „Allgemeine Verfügbarkeit“. Zusätzliche Funktionen sind in den Komponenten der gcloud CLI mit den Namen alpha und beta verfügbar. Mit diesen Komponenten können Sie die gcloud CLI mit Cloud Bigtable, Dataflow und anderen Teilen der Google Cloud verwenden, die noch nicht allgemein verfügbar sind.
Die aktuelle gcloud CLI-Version ist 415.0.0. Sie können frühere Versionen der gcloud CLI aus dem Downloadarchiv herunterladen und installieren.
Releasestufen
Die gcloud-Befehlszeilenbefehle haben die folgenden Releasestufen:
| Releasestufe | Label | Beschreibung |
|---|---|---|
| Allgemeine Verfügbarkeit | – | 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 zur Installation aufgefordert.
Befehlsgruppen
Innerhalb jeder Releaseebene sind gcloud-Befehlszeilenbefehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, die jeweils ein Produkt oder eine Funktion von Google Cloud oder dessen 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 alpha app |
Befehle für die Verwaltung von App Engine-Bereitstellungen in der Alphaphase |
gcloud-Befehlszeilenbefehle ausführen
Sie können gcloud-Kommandozeilenbefehle über die Befehlszeile und Skripts und andere Automatisierungen ausführen, z. B. wenn Sie Jenkins zur Automatisierung 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 global oder über Befehlsoptionen festgelegt werden. In diesem Fall hat der durch die Option festgelegte Wert Vorrang.
Bedienungshilfen aktivieren
Für einen optimierten Screenreader ist die gcloud CLI mit dem Attribut accessibility/screen_reader ausgestattet.
Führen Sie Folgendes aus, um die Bedienungshilfen-Property 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 durch Ausführen von gcloud init oder gcloud config set festlegen. 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, mit denen die Funktionsweise von Befehlen auf Aufrufebene gesteuert wird. Optionen überschreiben Werte, die in den Attributen der gcloud CLI festgelegt sind.
Positionsargumente und Optionen
Positionsargumente und Optionen wirken sich zwar auf die Ausgabe eines gcloud-Kommandozeilenbefehls aus, es gibt jedoch einen kleinen Unterschied in ihren Anwendungsfällen. Ein Positionsargument wird verwendet, um eine Entität zu definieren, auf der ein Befehl ausgeführt wird, während Optionen zum Festlegen einer Variante des Befehlsverhaltens erforderlich sind.
Nutzung von stdout und stderr
Die Ausgabe erfolgreicher gcloud-Kommandozeilenbefehle 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 sind, da diese Antworten nicht stabil sind.
Richtlinien für die Verarbeitung von Ausgaben finden Sie im Skripting-Leitfaden.
Aufforderungen
Zum Schutz vor unbeabsichtigten, folgenschweren Aktionen bestätigt die gcloud-Befehlszeile Ihre Intents, bevor Befehle wie gcloud projects delete ausgeführt werden.
Wenn Sie weitere Informationen benötigen, werden Sie möglicherweise dazu aufgefordert.
Sie werden beispielsweise aufgefordert, eine Zone auszuwählen, wenn Sie eine Compute Engine-VM-Instanz mit gcloud compute instances create test-instance erstellen.
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) für die gcloud-Befehlszeile deaktiviert alle interaktiven Eingabeaufforderungen beim Ausführen von gcloud-Kommandozeilenbefehlen und ist für Skripts hilfreich. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn es keine Standardeinstellung gibt, wird ein Fehler ausgegeben.
Verwenden Sie die Option --no-user-output-enabled, um das Drucken der Befehlsausgabe in der Standardausgabe und im Standardfehler im Terminal zu unterdrücken.
Wenn Sie die Ausführlichkeit von Logs ändern möchten, geben Sie mit der Option --verbosity einen Ausführlichkeitsgrad an (Fehlerbehebung, Informationen, Warnung, Fehler, kritisch oder keine).
Ausgabestruktur bestimmen
Wenn ein Befehl von gcloud CLI eine Liste von Ressourcen zurückgibt, werden die Ressourcen standardmäßig in der Standardausgabe ausgegeben. Mit den Optionen format, filter und projection können Sie die Ausgabe optimieren.
Wenn Sie nur das Format Ihrer Ausgabe definieren möchten, können Sie die Option --format verwenden, um eine tabellarische oder vereinfachte Version der Ausgabe (für die interaktive Anzeige) oder eine maschinenlesbare Version der Ausgabe (json, csv, yaml, value) zu 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 Formatfunktionen vertraut machen möchten, klicken Sie auf In Cloud Shell öffnen, um eine kurze interaktive Anleitung zu durchlaufen.
Nächste Schritte
- Weitere Informationen zu Befehlen der gcloud CLI finden Sie in der Referenz zur gcloud CLI.