Spickzettel für die gcloud-Befehlszeile

Eine Liste der Befehle für die Google Cloud CLI, das primäre Befehlszeilentool für Google Cloud.

(Außerdem enthalten: Einführung, Befehle verstehen und eine druckbare PDF-Datei).

Auf einen Blick

Erste Schritte

Erste Schritte mit der gcloud CLI

Hilfe

Die gcloud CLI unterstützt Sie gerne.

  • gcloud help: Durchsuchen Sie die Referenzdokumente der gcloud CLI nach bestimmten Begriffen.
  • gcloud feedback: Feedback für das gcloud CLI-Team.
  • gcloud topic: Zusätzliches Material für Nicht-Befehlsthemen wie Zugriff, Filterung und Formatierung.

Personalisierung

Machen Sie sich die gcloud CLI zu eigen; personalisieren Sie Ihre Konfiguration mit Attributen.

Autorisierung und Anmeldedaten

Sie können die Autorisierung für die gcloud CLI gewähren und widerrufen sowie Anmeldedaten verwalten.

Projekte

Richtlinien für den Projektzugriff verwalten

IAM

IAM-Einstellungen und -Dienstkonten konfigurieren

Docker und Google Kubernetes Engine (GKE)

Containerisierte Anwendungen in Kubernetes verwalten

Virtuelle Maschinen und Compute Engine

VMs in der Google Cloud-Infrastruktur erstellen, ausführen und verwalten.

Serverlos und App Engine

Hoch skalierbare Anwendungen auf einer vollständig verwalteten, serverlosen Plattform erstellen

Sonstiges

Nützliche Befehle

Einführung

Eine Kurzanleitung für die ersten Schritte mit der gcloud CLI.

Google Cloud-CLI installieren

Installieren Sie die Google Cloud CLI mithilfe dieser Installationsanleitung.

Flags, Argumente und andere Anderes

Argumente können Positionsargumente oder Flags sein:

  • Positionsargumente: Wird nach dem Befehlsnamen festgelegt. Muss die Reihenfolge der Positionsargumente berücksichtigen.

  • Flags: Wird nach Positionsargumenten festgelegt. Dabei spielt die Reihenfolge der Flags keine Rolle.

    Ein Flag kann eines der folgenden sein:

    • Name/Wert-Paar (--foo=bar) oder
    • Boolesch (--force/no-force).

    Darüber hinaus sind Flags:

    • Erforderlich
    • Optional:Wenn ein optionales Flag nicht definiert ist, wird der Standardwert verwendet.

Globale Flags

Einige Flags sind in der gesamten gcloud-Befehlszeile verfügbar, z. B.:

  • --help: Bei Zweifeln, die detaillierte Hilfe bei einem Befehl anzeigen.
  • --project: Wenn Sie ein anderes Projekt als das aktuelle Projekt verwenden.
  • --quiet: Interaktive Eingabe deaktivieren (und Standardwerte für Eingaben anwenden).
  • --verbosity: Kann Ausführlichkeitsstufen auf debug, info, warning, error, critical und none festlegen.
  • --version: Informationen zur gcloud-Version anzeigen.
  • --format: Legen Sie das Ausgabeformat so fest config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, oder yaml.

Ergebnisse bereinigen

Extrahieren Sie Ihre Ausgabe optimal mit den Filter-, Format-, Limit- und Sortier-Flags.

Für Compute Engine-Instanzen mit dem Präfix us und nicht mit dem Maschinentyp f1-micro:

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

Für eine Liste von Projekten, die am oder nach dem 15. Januar 2018 erstellt wurden, sortiert nach der ältesten Tabelle. Die Tabelle wird als Tabelle mit Projektnummer, Projekt-ID und Erstellungszeitspalten sowie Datumsangaben und Uhrzeiten in der lokalen Zeitzone angezeigt:

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

Eine Liste mit zehn Compute Engine-Instanzen mit dem Label my-label (beliebiger Wert):

gcloud compute instances list --filter="labels.my-label:*" --limit=10

Befehle verstehen

Die zugrunde liegenden Muster für gcloud CLI-Befehle, um die Selbsterkennung von Befehlen zu erleichtern.

gcloud-Befehlszeilenbefehle finden

Die gcloud CLI ist eine Struktur. Nicht-Blattknoten sind Befehlsgruppen und Blattknoten sind Befehle. Außerdem funktioniert die Tab-Vervollständigung für Befehle und Ressourcen.

Die meisten gcloud-Befehle haben das folgende Format:

gcloud + release level (optional) + component + entity + operation + positional args + flags

Beispiel: gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

Releasestufe

Releasestufe bezieht sich auf den Veröffentlichungsstatus des Befehls.

Beispiel: alpha für Alphabefehle, beta für Betabefehle, kein Release-Level für GA-Befehle erforderlich.

Komponente

Komponente bezieht sich auf die verschiedenen Google Cloud-Dienste.

Beispiel: compute für Compute Engine, app für App Engine usw.

Entity

Entität bezieht sich auf die Pluralform eines Elements oder einer Sammlung von Elementen unter einer Komponente.

Beispiel: disks, firewalls, images, instances, regions, zones für Compute

Aktion

Vorgang bezieht sich auf die imperative Verbform des Vorgangs, der für die Entität ausgeführt werden soll.

Beispiel: Häufige Vorgänge sind: describe, list, create/update, delete/clear, import, export, copy, remove, add, reset, restart, restore, run und deploy.

Positionsargumente:

Positionsargumente beziehen sich auf die erforderlichen, reihenfolgespezifischen Argumente, die zum Ausführen des Befehls erforderlich sind.

Beispiel: <INSTANCE_NAMES> ist das erforderliche Positionsargument für gcloud compute instances create.

Flags

Flags beziehen sich auf die zusätzlichen Argumente --flag-name(=value), die nach Positionsargumenten an den Befehl übergeben werden.

Beispiel: --machine-type=<MACHINE_TYPE> und --preemptible sind optionale Flags für gcloud compute instances create.