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.

Hinweis

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 des Cloud SDK 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 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 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 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_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 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