gcloud CLI – Übersicht

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 umfasst eine Reihe von Tools zum Erstellen und Verwalten 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 auch die gcloud CLI verwenden, um App Engine bereitzustellen. die Authentifizierung verwalten, die lokale Konfiguration anpassen andere Aufgaben zu erledigen.

gcloud CLI herunterladen und installieren

Die aktuelle Version der gcloud CLI ist 498.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 werden mit der gcloud CLI Befehle auf der Stufe „Allgemeine Verfügbarkeit“ installiert. Die gcloud CLI-Komponenten alpha und beta bieten zusätzliche Funktionalität. 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 CLI

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 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-Befehlszeile aufgefordert, sie zu installieren.

Befehlsgruppen

Innerhalb jeder Releasestufe sind gcloud-Befehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, von denen jede ein Produkt oder eine Funktion von Google Cloud oder ihrer 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 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-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-Befehlszeile verwenden.

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. A 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-Befehlszeile bietet eine Reihe von gcloud-Befehlszeilenoptionen, die die Funktionsweise von Befehlen auf Aufrufebene steuern. Optionen überschreiben Werte, die in gcloud-Befehlszeileneigenschaften festgelegt sind.

Positionsargumente und Optionen

Während Positionsargumente und -optionen die Ausgabe eines gcloud CLI verwenden, gibt es einen feinen Unterschied bei der Verwendung Cases. Mit einem Positionsargument wird eine Entität definiert, für die ein Befehl funktioniert, während eine Option erforderlich ist, um eine Variante des Befehlsverhaltens festzulegen.

Verwendung von stdout und stderr

Die Ausgabe erfolgreicher gcloud-Befehlszeilenbefehle wird in stdout geschrieben. Alle anderen Antworten – Aufforderungen, Warnungen und Fehler – werden in stderr geschrieben. Verwenden Sie kein Script für Antworten, die in stderr geschrieben wurden, weil sind diese Antworten nicht stabil.

Richtlinien zum Umgang mit Ausgaben finden Sie in der Leitfaden zur Erstellung von Skripts

Aufforderungen

Zum Schutz vor unbeabsichtigten, folgenschweren Aktionen Ihre Absichten bestätigt, bevor Befehle wie gcloud projects delete

Möglicherweise werden Sie aufgefordert, zusätzliche Informationen anzugeben. Beispielsweise werden Sie aufgefordert, eine Zone auszuwählen, wenn Sie mit gcloud compute instances create test-instance eine Compute Engine-VM-Instanz erstellen.

Verwenden Sie die Option --quiet, um Aufforderungen zu deaktivieren.

Schreibe nicht auf den Wortlaut der Aufforderungen, 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-Befehlen und ist für Scripting nützlich. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn es keine Standardeinstellung ist, wird ein Fehler ausgegeben.

Um zu unterdrücken, dass die Befehlsausgabe als Standardausgabe und Standardfehler ausgegeben wird, das Terminal verwenden Sie die Option --no-user-output-enabled.

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-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.

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.

In Cloud Shell öffnen

Nächste Schritte