Diese Seite enthält eine Übersicht über das gcloud-Befehlszeilentool gcloud und seine allgemeinen Befehlsmuster und -funktionen.
Was ist das gcloud-Tool?
Das gcloud-Befehlszeilentool ist das primäre CLI-Tool zum Erstellen und Verwalten von Google Cloud-Ressourcen. Mit diesem Tool lassen sich viele gängige Plattformaufgaben entweder über die Befehlszeile oder in Skripts und anderen Automatisierungen ausführen.
Mit dem gcloud-Tool 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 das gcloud-Tool auch verwenden, um App Engine-Anwendungen bereitzustellen, die Authentifizierung zu verwalten, die lokale Konfiguration anzupassen und andere Aufgaben auszuführen. Weitere Informationen zu den Funktionen des gcloud-Tools finden Sie in der Referenz zum gcloud-Tool.
Der gcloud-Spickzettel
Eine kurze Einführung in das gcloud-Tool, eine Liste häufig verwendeter Befehle und eine Übersicht über die Strukturierung dieser Befehle finden Sie im gcloud-Tool auf einen Blick.
Das gcloud-Tool und das Cloud SDK
Das gcloud-Tool ist Teil des Cloud SDK.
Bevor Sie das gcloud-Tool verwenden können, müssen Sie das Cloud SDK auf Ihr System herunterladen und installieren und das Cloud SDK initialisieren .
Standardmäßig installiert das Cloud SDK die Befehle des gcloud-Tools, die der allgemeinen Verfügbarkeit entsprechen. In den Cloud SDK-Komponenten alpha und beta sind zusätzliche Funktionen verfügbar. Mit diesen Komponenten können Sie das gcloud-Tool verwenden, um mit Cloud Bigtable, Dataflow und anderen Teilen der Google Cloud zu arbeiten, die noch nicht allgemein verfügbar sind.
Die gcloud-Tool-Releases haben dieselbe Versionsnummer wie das Cloud SDK.
Die aktuelle Cloud SDK-Version ist 365.0.1. Sie können ältere Versionen des Cloud SDK aus dem Downloadarchiv herunterladen und installieren.
gcloud-Tool herunterladen
Sie können die neueste Version von Cloud SDK, die das gcloud-Tool enthält, von der Downloadseite herunterladen.
Releasestufen
Die Befehle des gcloud-Tools 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. Hinweise zu Änderungen an Befehlen, die die aktuelle Funktionalität beeinträchtigen, finden Sie in den Versionshinweisen. |
| Beta | beta |
Befehle sind funktional zwar vollständig, können aber dennoch einige ausstehende Probleme haben. Wichtige Ä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 des Cloud SDK 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 vom gcloud-Tool zur Installation aufgefordert.
Befehlsgruppen
gcloud-Befehle sind auf jeder Releasestufe in einer verschachtelten Hierarchie von Befehlsgruppen angeordnet. Jede davon steht für ein Produkt oder eine Funktion der Cloud Platform oder deren Funktionsuntergruppen.
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 |
Befehle des gcloud-Tools ausführen
Sie können gcloud-Tool-Befehle auf dieselbe Weise über die Befehlszeile ausführen wie mit anderen Befehlszeilentools. Sie können auch gcloud-Tool-Befehle aus Skripts und anderen Automatisierungsmethoden ausführen, wenn Sie beispielsweise Jenkins zur Automatisierung von Google Cloud-Aufgaben verwenden.
Attribute
gcloud-Toolattribute sind Einstellungen, die sich auf das Verhalten des gcloud-Tools und anderer Cloud SDK-Tools auswirken. Manche dieser Attribute können global oder mit Befehls-Flags festgelegt werden. In diesem Fall hat der durch das Flag festgelegte Wert Vorrang.
Bedienungshilfen aktivieren
Wenn Sie einen optimierten Screenreader benötigen, können Sie das Attribut accessibility/screen_reader im gcloud-Tool verwenden.
Führen Sie folgenden Befehl aus, um dieses Attribut zu aktivieren:
gcloud config set accessibility/screen_reader true
Weitere Informationen zu den Bedienungshilfen des gcloud-Befehlszeilentools finden Sie in der Anleitung Bedienungshilfen aktivieren.
Konfigurationen
Eine Konfiguration ist eine benannte Reihe von gcloud-Befehlsattributen. Eine Konfiguration funktioniert wie ein Profil.
Wenn Sie das Cloud SDK 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.
Wenn Sie mit mehreren Projekten oder Autorisierungskonten arbeiten möchten, können Sie mit gcloud config configurations create mehrere Konfigurationen einrichten und zwischen den Konfigurationen wechseln. Innerhalb einer Konfiguration können Sie Eigenschaften anpassen.
Verwenden Sie beispielsweise das Attribut project, um Ihr Projekt in einer aktiven Konfiguration festzulegen:
gcloud config set project <project-id>
Ausführliche Beschreibungen zu diesen Konzepten finden Sie im Konfigurationsleitfaden.
Globale Flags
Das gcloud-Tool bietet eine Reihe von gcloud-weiten Flags. Diese steuern das Verhalten von Befehlen auf Aufrufebene. Flags überschreiben Werte, die in Cloud SDK-Attributen festgelegt sind.
Positionsargumente und Flags
Positionsargumente und Flags beeinflussen zwar die Ausgabe eines Befehls des gcloud-Tools, es gibt jedoch einen geringfügigen Unterschied in ihren Anwendungsfällen. Mit einem Positionsargument wird die Entität definiert, auf die ein Befehl angewendet wird, während ein Flag erforderlich ist, um eine andere Funktionsweise des Befehls festzulegen.
Verwendung von stdout und stderr
Die Ausgabe erfolgreicher Befehle des gcloud-Tools wird in stdout geschrieben. Alle anderen Antworten – Aufforderungen, Warnungen und Fehler – werden in stderr geschrieben. Erstellen Sie kein Skript für Antworten, die in stderr geschrieben wurden, da diese Antworten nicht stabil sind.
Richtlinien zur Verarbeitung der Ausgabe finden Sie in der Skriptanleitung.
Aufforderungen
Zum Schutz vor unbeabsichtigten, folgenschweren Aktionen fordert das gcloud-Tool Ihre Absichten auf, bevor Befehle wie gcloud projects delete ausgeführt werden.
Aufforderungen sind auch zu erwarten, wenn Sie mit gcloud compute instances create test-instance eine Compute Engine-VM-Instanz erstellen.
Sie werden aufgefordert, eine Zone auszuwählen, in der die Instanz erstellt werden soll.
Verwenden Sie das Flag --quiet, um Aufforderungen zu deaktivieren.
Erstellen Sie kein Skript für den Wortlaut der Aufforderungen, da sich der Wortlaut ändern kann.
Aufforderungen verhindern, in das Terminal schreiben und Logging
Das Flag --quiet (auch -q) für das gcloud-Tool deaktiviert alle interaktiven Eingabeaufforderungen beim Ausführen von gcloud-Befehlsbefehlen und ist nützlich für Skripts. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn es keinen Standard gibt, wird ein Fehler ausgelöst.
Mithilfe des Flags --no-user-output-enabled kann im Terminal die Anzeige der Befehlsausgabe in der Standardausgabe und Standardfehlerausgabe unterdrückt werden.
Wenn Sie die Ausführlichkeit von Logs anpassen möchten, geben Sie diese mit dem Flag --verbosity an.
Ausgabestruktur bestimmen
Wenn ein Befehl des gcloud-Tools eine Liste von Ressourcen zurückgibt, werden die Ressourcen standardmäßig bereits in der Standardausgabe ausgegeben. Für eine aussagekräftigere Ausgabe können Sie mit den Flags format, filter und projection die Ausgabe optimieren.
Wenn Sie nur das Format Ihrer Ausgabe definieren möchten, können Sie mit dem Flag --format eine tabellarische bzw. vereinfachte Ausgabe erstellen (für eine interaktive Anzeige) oder eine Maschine erstellen. einer lesbaren 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.
Um sich mit den Filter- und Formatfunktionen vertraut zu machen, können Sie eine kurze interaktive Anleitung absolvieren, indem Sie auf In Cloud Shell öffnen klicken.
Nächste Schritte
- Weitere Informationen zu Befehlen des
gcloud-Tools finden Sie in der Referenz zumgcloud-Tool.