Diese Seite enthält eine Übersicht über die Google Cloud CLI und ihre allgemeinen Befehlsmuster und -funktionen.
Was ist die gcloud CLI?
Die Google Cloud CLI ist 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 Automatisierungen erledigen.
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 496.0.0.
Auch wenn wir dringend empfehlen, die aktuelle Version von gcloud CLI können Sie auch frühere Versionen herunterladen und installieren aus dem Downloadarchiv.
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, installieren Sie sie und initialisieren.
Standardmäßig wird die gcloud CLI installiert
Befehle auf der Ebene „General Availability“ (Allgemeine Verfügbarkeit). Zusätzliche Funktionen sind
verfügbar in der gcloud CLI
Komponenten mit den Namen alpha
und beta
. Diese Komponenten
ermöglichen es Ihnen, über die gcloud CLI mit Bigtable zu arbeiten,
Dataflow und andere Teile von Google Cloud in einer früheren Version
als General Availability.
Spickzettel für die gcloud-Befehlszeile
Als kurze Einführung in die gcloud CLI finden Sie hier eine Liste häufig verwendeter verwendeten Befehlen und wie sie strukturiert sind, siehe gcloud CLI auf einen Blick
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 nicht standardmäßig installiert.
über die gcloud CLI. Mit dem Befehl gcloud components install
müssen Sie diese Komponenten separat installieren. Wenn Sie versuchen,
Alpha- oder Beta-Befehl
und die entsprechende Komponente ist nicht installiert.
werden Sie von der gcloud CLI aufgefordert, es zu installieren.
Befehlsgruppen
Innerhalb jeder Releasestufe sind gcloud-Kommandozeilenbefehle in einer verschachtelte Hierarchie von Befehlsgruppen, von denen jede ein Produkt oder von Google Cloud oder seinen funktionalen Untergruppen.
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 CLI-Befehle über die Befehlszeile und aus Skripts und anderen Automatisierungen – für wenn Sie Google Cloud-Aufgaben mit Jenkins automatisieren.
Attribute
Die Attribute der gcloud CLI sind Einstellungen, die Auswirkungen auf das Verhalten der gcloud CLI Werkzeuge. Einige dieser Eigenschaften können entweder oder Befehlsoptionen. In diesem Fall hat der von der Option festgelegte Wert Vorrang.
Bedienungshilfen aktivieren
Für eine optimierte Screenreader-Nutzung bietet die gcloud CLI
hat die Eigenschaft accessibility/screen_reader
.
Führen Sie folgenden Befehl aus, um die Eigenschaft 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 besteht aus einer Reihe von gcloud-Befehlszeileneigenschaften. Eine Konfiguration funktioniert wie ein Profil.
Wenn Sie zum ersten Mal die gcloud CLI verwenden, arbeiten Sie mit einem einzigen
Konfiguration mit dem Namen default
. Sie können Attribute festlegen, indem Sie den folgenden Befehl ausführen:
gcloud init
oder gcloud config set
. 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 die Funktionsweise von Befehlen auf Aufrufebene steuern. Optionen überschreiben Werte, die in den Attributen der gcloud CLI festgelegt sind.
Positionsargumente und Optionen
Positionsargumente und Optionen wirken sich auf die Ausgabe eines gcloud-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 erfolgreicher gcloud-Befehlszeilenbefehle wird in stdout
geschrieben. Alle anderen Antworten – Aufforderungen, Warnungen und Fehler – sind
in stderr
geschrieben. Erstellen Sie keine Scripts 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-Befehlszeile 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.
Sie werden beispielsweise aufgefordert, eine Zone auszuwählen, wenn Sie eine Compute Engine erstellen.
VM-Instanz mit gcloud compute instances create test-instance
Verwenden Sie die Option --quiet
, um Aufforderungen zu deaktivieren.
Schreiben Sie nicht den Wortlaut der Aufforderungen auf, da sich der Wortlaut ä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 CLI-Befehlen
und ist für Skripts nützlich. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn es
keine Standardeinstellung 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, warning, error, critical oder none).
Ausgabestruktur bestimmen
Wenn ein gcloud CLI-Befehl eine Liste von Ressourcen zurückgibt,
werden die Ressourcen
in der Standardausgabe optimiert. Zum Optimieren der Ausgabe können Sie die Optionen format
, filter
und projection
verwenden, damit die Ausgabe sinnvoller ist.
Um nur das Format der Ausgabe zu definieren, verwenden Sie den Parameter
--format
-Option, um eine tabellarische
vereinfachte Version Ihrer Ausgabe (zur interaktiven 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.
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 gcloud CLI-Befehlen finden Sie in der Referenz zur gcloud CLI