Gestione delle proprietà della gcloud CLI

Le proprietà sono le impostazioni che regolano il comportamento di gcloud CLI.

Puoi utilizzare le proprietà per definire un'impostazione per prodotto o servizio, ad esempio l'account utilizzato da gcloud CLI per l'autorizzazione, regione da utilizzare quando lavori con le risorse Compute Engine, oppure la possibilità di e disattivare i controlli automatici degli aggiornamenti dei componenti della gcloud CLI. Le proprietà possono essere utilizzate anche per definire le preferenze di gcloud CLI, come il livello di dettaglio e la configurazione dei prompt per i comandi gcloud CLI.

Proprietà e flag

gcloud CLI supporta flag globali e flag di comando che hanno lo stesso come proprietà dell'interfaccia alla gcloud CLI. Ad esempio, l'interfaccia a riga di comando gcloud supporta sia il flag --project sia la proprietà project. Le proprietà ti consentono di mantenere le stesse impostazioni per tutte le esecuzioni dei comandi, mentre i flag influiscono sul comportamento dei comandi su base di chiamata. Tieni presente che i flag sostituiscono le proprietà quando sono già impostati.

Configurazioni

Una configurazione è un insieme denominato Proprietà della gcloud CLI. gcloud CLI utilizza configurazione attiva iniziale denominata default. default è adatta alla maggior parte dei casi d'uso. Tuttavia, puoi anche creare configurazioni aggiuntive e passare da una all'altra in base alle esigenze.

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

gcloud config set project PROJECT_ID

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

gcloud config set compute/zone us-east1-b

Impostazione delle proprietà mediante 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 che segue:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Annullamento delle 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 cercare per la sezione Proprietà disponibili.

Passaggi successivi