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.