Cloud SDK-Attribute verwalten

Attribute sind Einstellungen, die die Funktionsweise des gcloud-Befehlszeilentools und anderer Cloud SDK-Tools steuern.

Sie können Attribute verwenden, um eine produkt- oder dienstspezifische Einstellung zu definieren, z. B. das Konto, das vom gcloud-Tool und anderen Cloud SDK-Tools für die Autorisierung verwendet werden soll, die Standardregion, die beim Arbeiten verwendet werden soll, oder sogar das Deaktivieren der automatischen Aktualisierungsüberprüfungen von Cloud SDK-Komponenten. Attribute können auch verwendet werden, um gcloud-Tool-Einstellungen wie Ausführlichkeitsstufe und die Konfiguration der Eingabeaufforderung für gcloud-Tool-Befehle zu definieren.

Attribute und Flags

Das gcloud-Tool unterstützt einige globale Flags und Befehls-Flags, die den gleichen Effekt wie Cloud SDK-Attribute haben. Das gcloud-Tool unterstützt beispielsweise sowohl das Flag --project als auch das Attribut project. Sie können mithilfe von Attributen die gleichen Einstellungen für alle Befehlsausführungen beibehalten, während Flags das Befehlsverhalten pro Aufruf beeinflussen. Flags überschreiben Properties, wenn beide festgelegt sind.

Konfigurationen

Eine Konfiguration ist ein benannter Satz von SDK-Attributen. Das gcloud-Tool verwendet eine Konfiguration mit dem Namen default als aktive Erstkonfiguration. default ist für die meisten Anwendungsfälle geeignet. Sie können jedoch auch zusätzliche Konfigurationen erstellen und bei Bedarf zwischen diesen wechseln.

Attribute auflisten

Führen Sie gcloud config list aus, um die Attribute in der aktiven Konfiguration aufzulisten:

gcloud config list

Das gcloud-Tool gibt die Liste der Attribute zurück:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Attribute festlegen

Führen Sie gcloud config set aus, um ein Attribut in der aktiven Konfiguration festzulegen:

gcloud config set project [PROJECT]

Zum Festlegen von Attributen, die sich nicht im Attributabschnitt core befinden, müssen Sie vor dem Attributnamen den jeweiligen Abschnitt gefolgt von einem Schrägstrich angeben:

gcloud config set compute/zone us-east1-b

Attribute mithilfe von Umgebungsvariablen festlegen

Sie können Attribute auch mit Umgebungsvariablen festlegen. Jedes Attribut hat eine entsprechende Umgebungsvariable, mit der es festgelegt werden kann. Der Name der Umgebungsvariable folgt dem Muster CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Sie können beispielsweise die Attribute core/project und compute/zone so festlegen:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Festlegung von Attributen aufheben

Mit gcloud config unset heben Sie die Festlegung eines Attributs in der aktiven Konfiguration auf:

gcloud config unset disable_usage_reporting

Verfügbare Attribute

Die Liste aller Attribute finden Sie, indem Sie gcloud topic configurations oder gcloud config set --help ausführen und nach dem Abschnitt "Verfügbare Attribute" suchen.

Nächste Schritte