Gestione delle configurazioni dell'interfaccia a riga di comando gcloud

Una configurazione è un insieme denominato di Google Cloud CLI proprietà. Queste proprietà sono coppie chiave/valore, organizzate in sezioni, che regolano il comportamento di gcloud CLI.

Le proprietà comunemente memorizzate nelle configurazioni includono la zona Compute Engine predefinita, il livello di dettaglio, i report sull'utilizzo, l'ID progetto e un account utente o di servizio attivo. Le configurazioni ti consentono di definire e attivare queste e altre impostazioni insieme come gruppo.

Le configurazioni vengono archiviate nella directory di configurazione utente (in genere ~/.config/gcloud su MacOS e Linux o %APPDATA%\gcloud su Windows); tu trovare la posizione della directory di configurazione eseguendo gcloud info --format='value(config.paths.global_config_dir)'. La configurazione può essere modificata impostando la variabile di ambiente CLOUDSDK_CONFIG. Inoltre, tieni presente che la directory di configurazione deve essere abilitata alla scrittura. Tuttavia, se utilizzi Cloud Shell, le preferenze dell'interfaccia a riga di comando gcloud vengono memorizzate in una cartella tmp temporanea, impostata solo per la scheda Cloud Shell corrente e non vengono mantenute da una sessione all'altra.

Se disponi di più configurazioni, puoi scegliere di alternare tra o eseguire comandi utilizzando una configurazione specifica (con del flag --configuration). Per ulteriori informazioni su come cambiare configurazione, consulta alla sezione seguente sull'attivazione delle configurazioni.

Per conoscere le configurazioni dalla riga di comando (insieme a un elenco completo) di proprietà disponibili e le sezioni in cui si trovano), esegui gcloud topic configurations

Configurazione predefinita

gcloud CLI inizia con una singola configurazione denominata default. Puoi impostare le proprietà nella configurazione eseguendo il comando gcloud init o direttamente il comando gcloud config set.

Ad esempio, per disabilitare la richiesta di script, esegui:

gcloud config set disable_prompts true

Più configurazioni

La configurazione singola default è adatta a molti casi d'uso. Tuttavia, puoi anche creare configurazioni aggiuntive e passare da una all'altra in base alle esigenze utilizzando gcloud config configurations activate. La configurazione iniziale di default non ha nulla di speciale; viene creata per comodità. Puoi assegnare un nome a questa ed eventuali configurazioni aggiuntive come desideri.

Più configurazioni sono utili se vuoi:

  • Utilizza più progetti: puoi creare una configurazione separata per ogni progetto e passare da uno all'altro in base alle esigenze.
  • Utilizzare più account di autorizzazione
  • Eseguire attività generalmente indipendenti: ad esempio, puoi utilizzare una per lavorare su un'applicazione App Engine in un solo progetto e gestire istanze Compute Engine non correlate progetto.

Creazione di una configurazione

Per creare una configurazione, esegui gcloud config configurations create:

gcloud config configurations create [NAME]

Per poterla utilizzare, devi attivare la nuova configurazione dopo la creazione.

Attivare una configurazione

In un determinato momento può essere attiva una sola delle più configurazioni. La configurazione attiva è la configurazione le cui proprietà regoleranno il comportamento dell'interfaccia a riga di comando gcloud.

Per attivare una nuova configurazione o passare a una nuova configurazione attiva, esegui: gcloud config configurations activate:

gcloud config configurations activate [NAME]

gcloud config list ti mostrerà sempre le proprietà nella configurazione attiva.

Per modificare la configurazione attiva per una singola chiamata di comando, puoi utilizzare il flag --configuration su qualsiasi comando gcloud CLI:

gcloud auth list --configuration=[CONFIGURATION_NAME]

Per modificare la configurazione attiva per tutti i comandi nel terminale attuale: puoi impostare la variabile di ambiente CLOUDSDK_ACTIVE_CONFIG_NAME sul nome della configurazione che vuoi utilizzare.

Automatizzare il passaggio tra configurazioni

Per semplificare la modifica delle configurazioni, puoi utilizzare strumenti come direnv e ondir per passare automaticamente da una configurazione all'altra quando cambi directory di lavoro. Un modo per farlo è impostare le variabili di ambiente necessarie (ad esempio CLOUDSDK_ACTIVE_CONFIG_NAME) nel file .envrc nella directory principale del progetto.

Configurazioni scheda

Per elencare le configurazioni nell'installazione di gcloud CLI, esegui gcloud config configurations list:

gcloud config configurations list

L'interfaccia a riga di comando gcloud elenca le configurazioni e mostra quale è attiva:

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Impostare le proprietà di configurazione

Per impostare e annullare l'impostazione delle proprietà nella configurazione attiva, esegui gcloud config set e gcloud config unset:

gcloud config set project [PROJECT]

gcloud config unset project

Le proprietà possono essere impostate anche tramite variabili di ambiente denominate CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Ad esempio, puoi impostare Proprietà core/project e compute/zone come segue:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Visualizzazione delle proprietà di configurazione

Per visualizzare le proprietà in una configurazione, esegui: gcloud config configurations describe:

gcloud config configurations describe [NAME]

In alternativa, per visualizzare le proprietà nella configurazione attiva:

gcloud config list

L'interfaccia a riga di comando gcloud stampa le proprietà di configurazione:

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

Eliminazione di una configurazione

Per eliminare una configurazione, esegui: gcloud config configurations delete:

gcloud config configurations delete [NAME]

Non puoi eliminare la configurazione attiva. Utilizza gcloud config configurations activate, se necessario, per passare a un'altra configurazione prima dell'eliminazione.

Passaggi successivi