gcloud-Befehlszeile

Diese Seite bietet einen Überblick über die Google Cloud-Befehlszeile und die gängigen Befehlsmuster und -funktionen.

Was ist die gcloud-Befehlszeile?

Die Google Cloud-Befehlszeile besteht aus einer 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 ausführen.

Mit der gcloud-Befehlszeile 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

Außerdem können Sie mit der gcloud-Befehlszeile App Engine-Anwendungen bereitstellen, die Authentifizierung verwalten, die lokale Konfiguration anpassen und andere Aufgaben ausführen.

Das gcloud-Befehlszeilentool auf einen Blick

Eine kurze Einführung in die gcloud-Befehlszeile, eine Liste häufig verwendeter Befehle und einen Überblick über die Struktur dieser Befehle finden Sie unter gcloud-Befehlszeile.

gcloud-Befehlszeile herunterladen und installieren

Wenn Sie Cloud Shell verwenden, ist die gcloud-Befehlszeile automatisch verfügbar und Sie müssen sie nicht installieren. Andernfalls laden Sie die gcloud-Befehlszeile herunter und installieren Sie sie und Initialisieren Sie sie.

Standardmäßig installiert die gcloud-Befehlszeile Befehle, die sich auf der Ebene „Allgemeine Verfügbarkeit“ befinden. Zusätzliche Funktionen sind in den Komponenten der gcloud-Befehlszeile mit dem Namen alpha und beta verfügbar. Mit diesen Komponenten können Sie die gcloud-Befehlszeile verwenden, um mit Cloud Bigtable, Dataflow und anderen Teilen der Google Cloud in früheren Releasestufen als bei der allgemeinen Verfügbarkeit zu arbeiten.

Die aktuelle gcloud-Befehlszeile ist 387.0.0. Sie können frühere Versionen der gcloud-Befehlszeile 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 vorherige Ankündigung geändert werden.

Die Komponenten alpha und beta sind bei der Installation der gcloud-Befehlszeile nicht standardmäßig installiert. Mit dem Befehl gcloud components install müssen Sie diese Komponenten separat installieren. Wenn Sie einen Alpha- oder Betabefehl ausführen und die entsprechende Komponente nicht installiert ist, werden Sie von der gcloud-Befehlszeile dazu aufgefordert.

Befehlsgruppen

Innerhalb jeder Release-Ebene sind gcloud-Befehlszeilenbefehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, die jeweils ein Produkt oder ein Feature 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-Befehlszeilenbefehle über die Befehlszeile und über Skripts und andere Automatisierungen ausführen, z. B. bei der Automatisierung von Google Cloud-Aufgaben mit Jenkins.

Attribute

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

Bedienungshilfen aktivieren

Für eine optimierte Screenreader-Nutzung ist die gcloud-Befehlszeile mit einer accessibility/screen_reader-Property ausgestattet.

Führen Sie folgenden Befehl 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 ein Satz von gcloud-Befehlszeilenattributen. Eine Konfiguration funktioniert wie ein Profil.

Wenn Sie die gcloud-Befehlszeile verwenden, verwenden Sie eine einzelne Konfiguration namens default und können Attribute mit 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-Befehlszeile bietet eine Reihe von gcloud-Befehlszeilenoptionen, mit denen das Verhalten von Befehlen auf Aufrufebene gesteuert wird. Optionen überschreiben Werte, die in gcloud-Befehlszeilenattributen festgelegt wurden.

Positionsargumente und Optionen

Positionsargumente und Optionen wirken sich auf die Ausgabe eines gcloud-Befehlszeilenbefehls aus. Es gibt aber einen kleinen Unterschied bei den jeweiligen Anwendungsfällen. Mit einem Positionsargument wird eine Entität definiert, für die ein Befehl ausgeführt wird, während eine Option zum Festlegen einer Variante im Befehl erforderlich ist.

Verwendung von stdout und stderr

Die Ausgabe erfolgreicher gcloud-Befehlszeilenbefehle 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 wurden, da diese Antworten nicht stabil sind.

Richtlinien für die Ausgabe finden Sie im Leitfaden für Skripts.

Aufforderungen

Zum Schutz vor unbeabsichtigten destruktiven Aktionen bestätigt die gcloud-Befehlszeile Ihre Intents, bevor Befehle wie gcloud projects delete ausgeführt werden.

Sie werden möglicherweise aufgefordert, zusätzliche Informationen zu benötigen. 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

Mit der Option --quiet (auch -q) für die gcloud-Befehlszeile werden alle interaktiven Eingabeaufforderungen deaktiviert, wenn gcloud-Befehlszeilenbefehle ausgeführt werden. Das ist nützlich für Skripts. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Gibt es einen Standardwert, wird ein Fehler ausgegeben.

Mit der Option --no-user-output-enabled kannst du das Drucken der Befehlsausgabe zur Standardausgabe und zum Standardfehler im Terminal unterdrücken.

Wenn Sie die Ausführlichkeit von Logs anpassen möchten, geben Sie mit der Option --verbosity eine Ausführlichkeitsstufe (Debug, Info, Warnung, Fehler, kritisch oder keine) an.

Ausgabestruktur bestimmen

Wenn ein gcloud-Befehl eine Liste von Ressourcen zurückgibt, werden die Ressourcen standardmäßig in der Standardausgabe ausgegeben. Für eine aussagekräftigere Ausgabe kannst du deine Ausgabe mit den Optionen format, filter und projection optimieren.

Wenn Sie nur das Format der Ausgabe definieren möchten, verwenden Sie die Option --format, 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.

In Cloud Shell öffnen

Weitere Informationen