Le proprietà sono 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, la regione predefinita da utilizzare quando lavori con le risorse Compute Engine o l'opzione per disattivare i controlli automatici degli aggiornamenti dei componenti dell'interfaccia a riga di comando gcloud. Le proprietà possono essere utilizzate anche per definire le preferenze dell'interfaccia a riga di comando gcloud CLI, come il livello di dettaglio e la configurazione dei prompt per i comandi dell'interfaccia a riga di comando gcloud CLI.
Proprietà e flag
gcloud CLI supporta alcuni flag globali e alcuni flag dei comandi che hanno lo stesso effetto delle proprietà dell'interfaccia a riga di comando gcloud. Ad esempio, gcloud CLI supporta sia il flag --project
che la proprietà project
. Le proprietà consentono di mantenere le stesse impostazioni in tutte le esecuzioni dei comandi, mentre i flag influiscono sul comportamento dei comandi su base ciascuna chiamata. Tieni presente che i flag sostituiscono le proprietà quando sono impostate entrambe.
Configurazioni
Una configurazione è un insieme denominato di
proprietà gcloud CLI. Gcloud CLI 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 esigenze.
Proprietà scheda
Per elencare le proprietà nella configurazione attiva, esegui gcloud config list
:
gcloud config list
gcloud CLI 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
Proprietà dell'impostazione
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 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 dell'impostazione delle proprietà
Per annullare l'impostazione di una proprietà nella configurazione attiva, utilizza
gcloud config unset
:
gcloud config unset disable_usage_reporting
Proprietà disponibili
Puoi trovare l'elenco di tutte le proprietà eseguendo gcloud topic configurations
o gcloud config set --help
e cercando la sezione Proprietà disponibili.
Passaggi successivi
- Leggi le configurazioni dell'interfaccia a riga di comando di gcloud per scoprire di più sulle configurazioni.