Gestione delle configurazioni gcloud CLI

Una configurazione è un insieme denominato di proprietà Google Cloud CLI. Queste proprietà sono coppie chiave-valore, organizzate in sezioni, che regolano il comportamento dellgcloud 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). Puoi trovare la posizione della directory di configurazione eseguendo gcloud info --format='value(config.paths.global_config_dir)'. La directory config 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 alla gcloud CLI vengono memorizzate in una cartella tmp temporanea, impostata solo per la scheda Cloud Shell corrente e non vengono mantenute nelle sessioni.

Se hai più configurazioni, puoi scegliere di passare da una all'altra o di eseguire comandi utilizzando una configurazione specifica (con l'aiuto del flag --configuration). Per saperne di più sul passaggio da una configurazione all'altra, consulta la sezione Attivare le configurazioni di seguito.

Per informazioni sulle configurazioni dalla riga di comando (oltre a un elenco completo delle proprietà disponibili e delle sezioni in cui si trovano), esegui gcloud topic configurations.

Configurazione predefinita

L'interfaccia a riga di comando gcloud 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 disattivare la richiesta di scripting, 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 e ad altre configurazioni aggiuntive come preferisci.

Più configurazioni sono utili se vuoi:

  • Utilizza più progetti: puoi creare una configurazione separata per ogni progetto e passare da una all'altra in base alle esigenze.
  • Utilizzare più account di autorizzazione
  • Esegui attività generalmente indipendenti: ad esempio, puoi utilizzare una configurazione per lavorare su un'applicazione App Engine in un progetto e gestire istanze Compute Engine non correlate in un altro 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.

Attivazione di 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 dellgcloud CLI.

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 un singolo richiamo 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 corrente, puoi impostare la variabile di ambiente CLOUDSDK_ACTIVE_CONFIG_NAME sul nome della configurazione che vuoi utilizzare.

Automatizzare il passaggio da una configurazione all'altra

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 della 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

Impostazione delle 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 le 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

Gcloud CLI 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