Die gcloud CLI auf einen Blick

Eine Liste von Go-to-Befehlen 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 hilft Ihnen gerne.

  • gcloud help: Suchen Sie in den Referenzdokumenten der gcloud CLI nach bestimmten Begriffen.
  • gcloud feedback: Geben Sie Feedback an das gcloud CLI-Team.
  • gcloud topic: Zusätzliches Material für Nicht-Befehlsthemen wie Zugriff, Filterung und Formatierung.

Personalisierung

Passen Sie die gcloud CLI an und personalisieren Sie die Konfiguration mit Attributen.

Autorisierung und Anmeldedaten

Autorisierung für die gcloud CLI gewähren und aufheben und Anmeldedaten verwalten

Projekte

Zugriffsrichtlinien für Projekte verwalten.

IAM

Einstellungen und Dienstkonten für die Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) konfigurieren

Docker und Google Kubernetes Engine (GKE)

Containeranwendungen 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 kurze Einführung in die 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 kein optionales Flag definiert ist, wird der Standardwert verwendet.

Globale Flags

Einige Flags sind in der gesamten gcloud CLI 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 zur Unterstützung der Selbsterkennung von Befehlen.

gcloud CLI-Befehle finden

Die gcloud CLI ist ein Baum. 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.