gcloud-Tool

Auf dieser Seite erhalten Sie eine Übersicht über das gcloud-Befehlszeilentool und die üblichen Befehlsmuster und Funktionen.

Was ist das gcloud-Tool?

Das gcloud-Befehlszeilentool ist das primäre Befehlszeilentool 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 Tool gcloud können Sie beispielsweise Folgendes erstellen und verwalten:

  • VM-Instanzen von Compute Engine und andere Ressourcen
  • Cloud SQL-Instanzen
  • GKE-Cluster
  • Dataproc-Cluster und -Jobs
  • Von Cloud DNS verwaltete Zonen und Datensätze
  • Cloud Deployment Manager-Bereitstellungen

Sie können das Tool gcloud 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 gcloud-Tool-Referenz.

Das gcloud-Tool auf einen Blick

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. Sie müssen das Cloud SDK auf Ihr System herunterladen und installieren und es initialisieren, bevor Sie das gcloud-Tool verwenden können.

Standardmäßig installiert das Cloud SDK nur die gcloud-Tool-Befehle, die der allgemeinen Verfügbarkeit entsprechen. In den Cloud SDK-Komponenten mit den Namen 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 von 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 357.0.0. Sie können ältere Versionen des Cloud SDK aus dem Downloadarchiv herunterladen und installieren.

gcloud-Tool herunterladen

Sie können die neueste Version des 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. Für Befehle, die die aktuelle Funktionalität ändern, werden Vorwarnungen ausgegeben und in den Versionshinweisen dokumentiert.
Beta beta Die Befehle sind funktional vollständig, können aber noch einige ungelöste Probleme aufweisen. Nicht abwärtskompatible Ä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. Sie müssen diese Komponenten mit dem Befehl gcloud components install 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

Auf jeder Release-Ebene sind die Befehle des gcloud-Tools in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, von denen jede ein Produkt oder ein Merkmal von Google Cloud oder seinen 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

Befehle des gcloud-Tools ausführen

Befehle des gcloud-Tools lassen sich auf dieselbe Weise wie andere Befehlszeilentools über die Befehlszeile ausführen. Sie können auch Befehle des gcloud-Tools aus Skripts und anderen Automatisierungen ausführen, z. B. wenn Sie Jenkins zur Automatisierung von Google Cloud-Aufgaben verwenden.

Attribute

Eigenschaften des gcloud-Tools 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

Für einen optimierten Screenreader enthält das gcloud-Tool das Attribut accessibility/screen_reader.

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 im Handbuch zum Aktivieren von Bedienungshilfen.

Konfigurationen

Eine Konfiguration ist ein benannter Satz von gcloud-Tool-Properties. Sie funktioniert wie ein Profil.

Sie beginnen mit dem Cloud SDK und verwenden eine einzige Konfiguration mit dem Namen default. Sie können Attribute festlegen, indem Sie entweder 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 verschiedene Konfigurationen mit gcloud config configurations create festlegen und zwischen ihnen wechseln. Innerhalb dieser Konfigurationen können Sie Attribute anpassen. Um Ihr Projekt beispielsweise in einer aktiven Konfiguration festzulegen, verwenden Sie das project-Attribut: 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 Tool-Flags im gcloud-Tool, die das Verhalten von Befehlen auf Aufrufebene steuern. Flags überschreiben alle Werte, die in Cloud SDK-Attributen festgelegt sind.

Positionsargumente und Flags

Positionsargumente und Flags wirken sich zwar auf die Ausgabe eines Befehls des gcloud-Tools aus, aber die Anwendungsfälle unterscheiden sich geringfügig. Mit einem Positionsargument wird eine Entität definiert, für die ein Befehl ausgeführt wird. Ein Flag ist erforderlich, um eine andere Funktionsweise des Befehls festzulegen.

stdout und stderr verwenden

Die erfolgreiche Ausgabe der Befehle des gcloud-Tools wird in stdout geschrieben. Alle anderen Antworten – Aufforderungen, Warnungen und Fehler – werden in stderr geschrieben. Was in stderr geschrieben wird, ist nicht stabil und sollte nicht für Skripts verwendet werden.

Eine aktuelle Liste von Richtlinien zum Umgang mit Ausgaben finden Sie im Skript-Leitfaden.

Aufforderungen

Zum Schutz vor unbeabsichtigten, schädlichen Aktionen bestätigt das gcloud-Tool Ihre Absichten, 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, beispielsweise "test-instance". Sie werden aufgefordert, eine Zone auszuwählen, in der die Instanz erstellt werden soll.

Verwenden Sie das Flag --quiet, um Aufforderungen zu deaktivieren.

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 was bei der Skripterstellung nützlich ist. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn keine Standardeinstellungen vorhanden sind, wird ein Fehler ausgegeben.

Mithilfe des Flags --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 stattdessen anzupassen, verwenden Sie das Flag --verbosity mit einer geeigneten Ebene (Debug, Info, Warnung, Fehler, kritisch oder keine).

Ausgabestruktur bestimmen

Wenn ein Befehl des gcloud-Tools eine Liste von Ressourcen zurückgibt, werden sie standardmäßig in der Standardausgabe angezeigt. Für eine aussagekräftigere Ausgabe können Sie mit den Flags für Format, Filter und Projektion die Ausgabe optimieren.

Wenn Sie nur das Format Ihrer Ausgabe definieren möchten, erstellen Sie mit dem Flag --format eine tabellarische bzw. vereinfachte Version für eine interaktive Anzeige oder eine maschinenlesbare Version der Ausgabe als 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.

Über den nachfolgenden Link gelangen Sie zu einer kurzen interaktiven Anleitung, in der Sie sich mit den Filter- und Formatfunktionen vertraut machen können.

In Cloud Shell öffnen

Nächste Schritte