gcloud compute

Mit der Google Cloud CLI können Sie Ihre Compute Engine-Ressourcen mit der Befehlsgruppe gcloud compute verwalten. gcloud compute ist eine Alternative zur Compute Engine API.

Die gcloud-Befehlszeile ist Teil des Google Cloud CLI. Es ist ein einheitliches Befehlszeilentool, das Features wie Autovervollständigung von Anweisungen, lokale Aktualisierungen, Befehlszeilenhilfe, für Menschen lesbare und maschinenlesbare Ausgabeformate sowie Einbindung in das Google Cloud CLI beinhaltet.

Wenn Sie Compute Engine noch nie verwendet haben, können Sie entweder mit der Linux-Kurzanleitung oder der Windows-Kurzanleitung beginnen.

Vorbereitung

Standardattribute

Wenn Sie eine VM-Instanz erstellen, konfiguriert Compute Engine eine VM mit den Standardattributen aus dem Metadatenserver. Sie können die Standardattribute Ihrer VM prüfen, indem Sie den folgenden Befehl ausführen:

gcloud compute project-info describe --project PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

Standardprojekt

Wenn Sie bei der Einrichtung und Initialisierung der Google Cloud CLI ein Standardprojekt festgelegt haben, verwenden alle gcloud compute-Befehle diese Projekt-ID standardmäßig.

Sie können die Standardprojekt-ID mit einer der folgenden Methoden überschreiben:

  • Führen Sie jeden gcloud compute-Befehl mit dem Flag --project aus.

  • Legen Sie die Umgebungsvariable CLOUDSDK_CORE_PROJECT fest.

    Linux und macOS

    Legen Sie mit dem Befehl export die Umgebungsvariable des Projekts fest.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die Projekt-ID des Projekts, das Sie als Standard verwenden möchten.

    Umgebungsvariablen für Projekte aufheben

    Wenn Sie die Festlegung der Umgebungsvariablen in Ihrem Projekt aufheben müssen, verwenden Sie die folgenden unset-Befehle:

    unset CLOUDSDK_CORE_PROJECT

    Windows

    Legen Sie mit dem Befehl set die Umgebungsvariable des Projekts fest.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die Projekt-ID des Projekts, das Sie als Standard verwenden möchten.

    Umgebungsvariablen für Projekte aufheben

    Wenn Sie die Festlegung der Umgebungsvariablen in Ihrem Projekt aufheben müssen, verwenden Sie den folgenden Befehl:

    set CLOUDSDK_CORE_PROJECT=

Falls Sie kein Standardprojekt und keine Umgebungsvariable definieren, muss jeder von Ihnen ausgeführte gcloud compute-Befehl ein --project-Flag enthalten.

Standardregion und -zone

Für einige gcloud compute-Befehle sind die Flags --region oder --zone erforderlich. Statt diese Flags jedes Mal bei der Ausführung von Befehlen anzugeben, können Sie eine Standardregion und -zone für das Projekt festlegen. Wenn Sie keine Standardregion oder -zone festlegen und einen regional oder zonenabhängigen Befehl ausführen, wird die Google Cloud CLI Sie möglicherweise zur Angabe eines Flags vom Typ --region oder --zone auffordern oder einen Fehler zurückgeben.

Sie können die Standardregion und -zone auf drei Arten festlegen:

  • Auf dem Metadatenserver. Die auf dem Metadatenserver festgelegte Standardregion und -zone werden bei der Ausführung von gcloud init auf den lokalen Client angewendet.
  • Im lokalen Client. Die Standardregion und -zone, die im lokalen Client festgelegt sind, überschreiben die auf dem Metadatenserver festgelegte Standardregion und -zone.
  • In Umgebungsvariablen. Die in den Umgebungsvariablen festgelegte Standardregion und -zone überschreiben die Standardregion und -zone, die im lokalen Client und auf dem Metadatenserver festgelegt sind.

Für das Überschreiben der Standardregion und -zone auf dem Metadatenserver, im lokalen Client oder in Umgebungsvariablen geben Sie die Flags --region und --zone an, wenn Sie Befehle ausführen.

Standardregion und -zone ansehen

Führen Sie die folgenden Befehle aus, um Ihre Standardregion und -zone anzusehen:

gcloud config get-value compute/region
 
gcloud config get-value compute/zone

Wenn die Ausgabe (unset) lautet, ist keine Standardregion oder -zone festgelegt.

Verfügbare Regionen und Zonen ansehen

Mit den folgenden Befehlen können Sie eine Liste von Regionen und Zonen aufrufen:

gcloud compute regions list
 
gcloud compute zones list

Standardregion und -zone auf dem Metadatenserver festlegen

Die Standardregion und -zone auf dem Metadatenserver gelten für alle configurations in Ihrem Projekt. So legen Sie die Standardregion und -zone auf dem Metadatenserver fest:

  1. Legen Sie die Standardregion und -zone fest:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE

    Beispiel:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

  2. Initialisieren Sie die Änderung in Ihrem lokalen Client:

    gcloud init

Sie können die auf dem Metadatenserver festgelegte Standardregion und -zone überschreiben, indem Sie entweder die Standardregion und -zone in Ihrem lokalen Client festlegen, die Standardregion und -zone in Umgebungsvariablen festlegen oder eines der Flags --zone und --region in Ihre Befehle aufnehmen.

Standardregion und -zone auf dem Metadatenserver aufheben

So heben Sie die Standardregion und -zone auf dem Metadatenserver auf:

  1. Metadaten aufheben:

    gcloud compute project-info remove-metadata \
   --keys=google-compute-default-region,google-compute-default-zone

  2. Initialisieren Sie die Änderung in Ihrem lokalen Client:

    gcloud init

Standardregion und -zone im lokalen Client festlegen

Die Standardregion und -zone, die im lokalen Client festgelegt sind, überschreiben die auf dem Metadatenserver festgelegte Standardregion und -zone.

Führen Sie die folgenden Befehle aus, um die Standardregion und -zone im lokalen Client festzulegen:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Standardregion und -zone im lokalen Client aufheben

Führen Sie die folgenden Befehle aus, um die Standardregion oder -zone im lokalen Client aufzuheben:

gcloud config unset compute/zone

gcloud config unset compute/region

Sie können die in Ihrem lokalen Client festgelegte Standardregion und -zone überschreiben, indem Sie die Standardregion und -zone in Umgebungsvariablen festlegen oder eines der Flags --zone und --region in Ihre Befehle aufnehmen.

Standardregion und -zone in Umgebungsvariablen festlegen

Die in den Umgebungsvariablen festgelegte Standardregion und -zone überschreiben die Standardregion und -zone, die im lokalen Client und auf dem Metadatenserver festgelegt sind.

Linux und macOS

Verwenden Sie den Befehl export, um die Regions- und Zonenvariablen festzulegen.

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

Damit diese Umgebungsvariablen dauerhaft gelten, nehmen Sie diese Befehle in Ihre ~/.bashrc-Datei auf und starten Sie Ihr Terminal neu.

Windows

Verwenden Sie den Befehl set, um die Regions- und Zonenvariablen festzulegen.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Sie können Umgebungsvariablen überschreiben, indem Sie das Flag --zone oder --region in die Befehle aufnehmen.

Standardregion und -zone in Umgebungsvariablen aufheben

Heben Sie mit den folgenden Befehlen die Standardregion und -zone in Umgebungsvariablen auf.

Linux und macOS

Verwenden Sie die folgenden unset-Befehle, um die Umgebungsvariablen für die Region und Zone aufzuheben:

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

Verwenden Sie die folgenden Befehle, um die Umgebungsvariablen für die Region und Zone aufzuheben:

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Standardzone mit Flags überschreiben

Mit dem Flag --zone überschreiben Sie die Standardzone, die auf dem Metadatenserver, auf Ihrem lokalen Client und in Umgebungsvariablen festgelegt ist.

Beispiel:

gcloud compute instances create example-instance \
    --zone=ZONE

Konfigurationen

gcloud topic configurations ist ein erweitertes Feature, mit dem Sie das Verhalten der gcloud CLI beeinflussen können. Für die meisten Nutzer sind Standardkonfigurationen ausreichend.

Konfigurationen können für Nutzer hilfreich sein, die:

  • Mit mehreren Projekten arbeiten. Sie können für jedes Projekt eine eigene Konfiguration erstellen.
  • Mehrere Konten verwenden. Dies kann beispielsweise ein Nutzerkonto und ein Dienstkonto sein.
  • Verschiedene unabhängige Aufgaben ausführen (Arbeiten an einer App Engine-Anwendung in einem Projekt, Verwalten eines Compute Engine-Clusters in der Zone „us-central-1a“, Verwalten der Netzwerkkonfigurationen für die Region „asia-east-1“ usw.)

Führen Sie den folgenden Befehl aus, um zwischen Konfigurationen zu wechseln:

gcloud config configurations activate CONFIGURATION_NAME

Weitere Informationen zum Verwalten von Konfigurationen finden Sie unter gcloud config configurations.

Nächste Schritte