gcloud compute


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.

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.

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:

  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_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.

Weitere Informationen