Auf dieser Seite finden Sie eine Übersicht über das Google Cloud CLI sowie die gängigen Befehlsmuster und Funktionen.
Was ist die gcloud CLI?
Die Google Cloud CLI ist eine Reihe von Tools zum Erstellen und Verwalten vonGoogle Cloud -Ressourcen. Mit diesen Tools lassen sich viele gängige Plattformaufgaben entweder über die Befehlszeile oder in Skripts und anderen Automatisierungen ausführen.
Sie können beispielsweise die gcloud CLI verwenden, um Folgendes zu erstellen und zu verwalten:
- VM-Instanzen und andere Ressourcen von Compute Engine
- Cloud SQL-Instanzen
- Google Kubernetes Engine-Cluster
- Managed Service for Apache Spark-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 587.0.0.
Wir empfehlen dringend, die aktuelle Version der gcloud CLI zu verwenden. Sie können aber auch frühere Versionen aus dem Downloadarchiv herunterladen und installieren.
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 und installieren Sie sie und initialisieren Sie sie.
Standardmäßig werden mit der gcloud CLI Befehle auf der Stufe „Allgemeine Verfügbarkeit“ installiert. Zusätzliche Funktionen sind in den gcloud CLI-Komponenten mit den Namen alpha, beta und preview verfügbar. Mit diesen Komponenten können Sie die gcloud CLI verwenden, um mit Bigtable, Dataflow und anderen Teilen der Google Cloud zu arbeiten, die noch nicht allgemein verfügbar sind.
gcloud CLI auf einen Blick
Eine kurze Einführung in die gcloud CLI, eine Liste häufig verwendeter Befehle und Informationen zur Struktur dieser Befehle finden Sie im gcloud CLI-Spickzettel.
Releasestufen
Die gcloud CLI-Befehle haben die folgenden Release-Stufen:
| 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. |
| Vorschau | preview |
Befehle sind auf dem Vorabversionsniveau und werden verwendet, um Feedback von Kunden zu sammeln. Vorabversionen werden in der Regel öffentlich angekündigt, bieten aber nicht unbedingt die vollständige Funktionspalette. Sie unterliegen keinen SLAs oder Verpflichtungen zum technischen Support. Sofern nicht anderweitig von Google angegeben, sind Vorschauangebote nur zur Verwendung in Testumgebungen vorgesehen. Im Durchschnitt dauert diese Phase etwa sechs Monate. |
| 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, beta und preview 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-, Beta- oder Preview-Befehl auszuführen und die entsprechende Komponente nicht installiert ist, werden Sie von der gcloud CLI aufgefordert, sie zu installieren.
Befehlsgruppen
Innerhalb jeder Release-Stufe sind die gcloud CLI-Befehle in einer verschachtelten Hierarchie von Befehlsgruppen organisiert, die jeweils ein Produkt oder eine Funktion von Google Cloud oder deren 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 preview |
Befehle im Zusammenhang mit Google Cloud in der Vorschau |
gcloud alpha app |
Befehle für die Verwaltung von App Engine-Bereitstellungen in der Alphaphase |
gcloud CLI -Befehle ausführen
Sie können gcloud CLI-Befehle über die Befehlszeile und über Skripts und andere Automatisierungen ausführen, z. B. beim Automatisieren von Google Cloud Aufgaben mit Jenkins.
Attribute
Die gcloud CLI-Attribute sind Einstellungen, die sich auf das Verhalten der gcloud CLI-Tools auswirken. Einige dieser Attribute können entweder durch globale Optionen oder durch Befehlsoptionen festgelegt werden. In diesem Fall hat der durch die Option festgelegte Wert Vorrang.
Bedienungshilfen aktivieren
Für eine optimierte Screenreader-Bedienung ist in der gcloud CLI die Property accessibility/screen_reader verfügbar.
Führen Sie folgenden Befehl aus, um die Bedienungshilfen-Eigenschaft 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 eine Reihe von gcloud CLI-Attributen. Eine Konfiguration funktioniert wie ein Profil.
Wenn Sie mit der gcloud CLI arbeiten, verwenden Sie eine einzelne Konfiguration mit dem Namen default. Sie können Eigenschaften 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 CLI bietet eine Reihe von gcloud CLI-Optionen, die das Verhalten von Befehlen auf Aufrufebene steuern. Optionen überschreiben alle Werte, die in gcloud CLI-Attributen festgelegt sind.
Positionsparameter und Optionen
Positionsparameter und Optionen wirken sich auf die Ausgabe eines gcloud CLI-Befehls aus. Es gibt jedoch einen subtilen Unterschied in ihren Anwendungsfällen. Mit einem Positionsargument wird eine Einheit definiert, für die ein Befehl ausgeführt wird. Mit einer Option wird eine Variation im Verhalten eines Befehls festgelegt.
Verwendung von stdout und stderr
Die Ausgabe erfolgreicher gcloud CLI-Befehle wird in stdout geschrieben. Alle anderen Arten von Antworten – Prompts, Warnungen und Fehler – werden in stderr geschrieben. Verwenden Sie keine Scripts für Antworten, die für stderr geschrieben wurden, da diese Antworten nicht stabil sind.
Richtlinien für den Umgang mit der Ausgabe finden Sie im Scripting-Leitfaden.
Prompting
Um unbeabsichtigte destruktive Aktionen zu verhindern, bestätigt die gcloud CLI Ihre Absichten, bevor Befehle wie gcloud projects delete ausgeführt werden.
Möglicherweise werden Sie aufgefordert, zusätzliche Informationen anzugeben.
Wenn Sie beispielsweise eine Compute Engine-VM-Instanz mit gcloud compute instances create test-instance erstellen, werden Sie aufgefordert, eine Zone auszuwählen.
Wenn Sie die Aufforderung deaktivieren möchten, verwenden Sie die Option --quiet.
Verlassen Sie sich nicht auf die Formulierung von Prompts, da sie sich ändern kann.
Aufforderungen verhindern, in das Terminal schreiben und Logging
Die Option --quiet (auch -q) für die gcloud CLI deaktiviert alle interaktiven Eingabeaufforderungen beim Ausführen von gcloud CLI-Befehlen und ist nützlich für die Skripterstellung. Wenn eine Eingabe erforderlich ist, werden die Standardeinstellungen verwendet. Wenn kein Standardwert vorhanden 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.
Wenn Sie die Ausführlichkeit von Logs anpassen möchten, 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 standardmäßig in einem lesbaren Format in der Standardausgabe ausgegeben. Mit den Optionen format, filter und projection können Sie die Ausgabe optimieren, um aussagekräftigere Ergebnisse zu erhalten.
Wenn Sie nur das Format Ihrer Ausgabe definieren möchten, verwenden Sie die Option --format, um eine tabellarische oder vereinfachte Version Ihrer 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.
Nächste Schritte
- Weitere Informationen zu gcloud CLI-Befehlen finden Sie in der gcloud CLI-Referenz.