gcloud compute

Linux-VMs Windows-VMs

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

Das gcloud-Tool ist Teil des Cloud SDK. Dieses umfassende Befehlszeilentool bietet Features wie die automatische Vervollständigung von Anweisungen, direkte Aktualisierungen, Hilfefunktionen für die Befehlszeile, menschen- und maschinenlesbare Ausgabeformate sowie die Einbindung in das Cloud SDK.

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

Hinweis

Wenn Sie gcloud compute in einer Eingabeaufforderung ausführen möchten, installieren, aktualisieren und initialisieren Sie das Cloud SDK.
Wenn Ihnen im Moment keine Eingabeaufforderung zur Verfügung steht, können Sie gcloud compute in Cloud Shell verwenden. Cloud Shell wird automatisch mit dem neuesten Cloud SDK installiert, aktualisiert und initialisiert.

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.

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 das gcloud-Befehlszeilentool 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 die Standardregion und -zone Ihrer Konfiguration aufzurufen:

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 Konfigurationen in Ihrem Projekt. So legen Sie die Standardregion und -zone auf dem Metadatenserver fest:

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

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:

Metadaten aufheben:

gcloud compute project-info remove-metadata \
   --keys=[google-compute-default-region | google-compute-default-zone]

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_CORE_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_CORE_PROJECT=

set CLOUDSDK_COMPUTE_ZONE=

Standardregion und -zone mit Flags überschreiben

Mit den Flags --region und --zone können Sie die Standardregion und -zone überschreiben, die auf dem Metadatenserver, im lokalen Client und in Umgebungsvariablen festgelegt sind.

Beispiel:

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

Konfigurationen

gcloud topic configurations ist ein erweitertes Feature, mit dem Sie das Verhalten des gcloud-Tools 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

Folgen Sie der Kurzanleitung für das gcloud-Befehlszeilentool.
Sehen Sie sich die Tipps zur Nutzung von gcloud compute an.
Entdecken Sie Allgemeine gcloud compute-Befehle.