Das gcloud-Tool auf einen Blick

Das gcloud-Tool auf einen Blick

Eine Liste mit Go-to-Befehlen für das gcloud-Befehlszeilentool, dem primären Befehlszeilentool für Google Cloud.

(Einschließlich Einführungsgrundlage, Erläuterungen zu Befehlen und einer druckbaren PDF-Datei)

Auf einen Blick

Erste Schritte

Jetzt mit dem gcloud-Tool loslegen.

Hilfe

Das Cloud SDK unterstützt Sie gerne.

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

Personalisierung

Machen Sie sich das Cloud SDK zu eigen; personalisieren Sie Ihre Konfiguration mit Attributen.

Anmeldedaten

Autorisierung für Cloud SDK gewähren und widerrufen

Projekte

Richtlinien für den Projektzugriff verwalten

IAM

IAM-Einstellungen (Identity and Access Management) 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 kurze Einführung in die Verwendung des gcloud-Tools

Cloud SDK installieren

Installieren Sie das Cloud SDK mit diesen Installationsanweisungen.

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: In diesem Fall wird der Standardwert verwendet, wenn das Flag nicht definiert ist.

Globale Flags

Einige Flags sind während des gesamten gcloud-Tools 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

Mit den Flags Filter, Format, Limit und Sort-by können Sie Ihre Ausgabe optimal nutzen.

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

Für eine Liste von 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-Tool-Befehle um die Erkennung von Befehlen zu erleichtern.

gcloud-Tool-Befehle finden

Das Tool gcloud ist eine Baumstruktur. 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.