Gestione delle proprietà dell'interfaccia a riga di comando gcloud

Le proprietà sono impostazioni che regolano il comportamento dell'interfaccia a riga di comando gcloud.

Puoi utilizzare le proprietà per definire un'impostazione per prodotto o per servizio, ad esempio l'account utilizzato dall'interfaccia a riga di comando gcloud per l'autorizzazione, l'area geografica predefinita da utilizzare durante il lavoro con le risorse di Compute Engine o l'opzione per disattivare i controlli automatici degli aggiornamenti dei componenti dell'interfaccia a riga di comando. Le proprietà possono essere utilizzate anche per definire le preferenze dell'interfaccia a riga di comando gcloud come il livello di dettaglio e la configurazione della richiesta per i comandi dell'interfaccia a riga di comando gcloud.

Proprietà e flag

L'interfaccia a riga di comando gcloud supporta alcuni flag globali e flag di comando con lo stesso effetto delle proprietà dell'interfaccia a riga di comando gcloud. Ad esempio, l'interfaccia a riga di comando gcloud supporta sia il flag --project sia la proprietà project. Le proprietà consentono di mantenere le stesse impostazioni nelle esecuzioni dei comandi mentre i flag influiscono sul comportamento dei comandi per ogni chiamata. Tieni presente che i flag sostituiscono le proprietà quando vengono impostati entrambi.

Configurazioni

Una configurazione è un insieme denominato di proprietà dell'interfaccia a riga di comando gcloud. L'interfaccia a riga di comando gcloud utilizza una configurazione denominata default come configurazione attiva iniziale. La configurazione default è adatta alla maggior parte dei casi d'uso. Tuttavia, puoi anche creare configurazioni aggiuntive e passare da una configurazione all'altra in base alle necessità.

Proprietà scheda

Per elencare le proprietà nella configurazione attiva, esegui gcloud config list:

gcloud config list

L'interfaccia a riga di comando gcloud restituisce l'elenco delle proprietà:

[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

Impostazione delle proprietà

Per impostare una proprietà nella configurazione attiva, esegui gcloud config set. L'esempio seguente imposta la proprietà project, dove PROJECT_ID è l'ID univoco del tuo progetto.

gcloud config set project PROJECT_ID

Per impostare proprietà che non si trovano nella sezione core, devi specificare la sezione seguita da una barra prima del nome della proprietà. L'esempio seguente imposta il nome della zona su us-east1-b.

gcloud config set compute/zone us-east1-b

Impostazione delle proprietà utilizzando le variabili di ambiente

Puoi anche impostare le proprietà utilizzando le variabili di ambiente. Ogni proprietà ha una variabile di ambiente corrispondente che può essere utilizzata per impostarla. Il nome della variabile di ambiente segue il pattern CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Ad esempio, puoi impostare le proprietà core/project e compute/zone come segue:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Annullamento impostazione proprietà

Per annullare l'impostazione di una proprietà nella configurazione attiva, utilizza gcloud config unset:

gcloud config unset disable_usage_reporting

Proprietà disponibili

Per trovare l'elenco di tutte le proprietà, esegui gcloud topic configurations o gcloud config set --help e cerca la sezione Proprietà disponibili.

Passaggi successivi