Gestione delle configurazioni gcloud CLI

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

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

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

Se disponi di più configurazioni, puoi scegliere di passare da una configurazione all'altra o di eseguire comandi utilizzando una configurazione specifica (con l'aiuto del flag --configuration). Per saperne di più sul cambio di configurazione, consulta la sezione Attivazione delle configurazioni più avanti.

Per saperne di più 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 gcloud config set.

Ad esempio, per disattivare la richiesta di scripting, esegui:

gcloud config set disable_prompts true

Configurazioni multiple

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

Le configurazioni multiple sono utili se vuoi:

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

Devi attivare la nuova configurazione dopo la creazione per utilizzarla.

Attivazione di una configurazione

Può essere attiva solo una delle configurazioni alla volta. La configurazione attiva è quella le cui proprietà regoleranno il comportamento di gcloud 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 mostrerà sempre le proprietà nella configurazione attiva.

Per modificare la configurazione attiva per la chiamata di un singolo comando, puoi utilizzare il flag --configuration in 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.

Automazione del cambio di configurazione

Per semplificare il cambio di configurazione, puoi utilizzare strumenti come direnv e ondir per passare automaticamente da una configurazione all'altra quando passi da una directory di lavoro all'altra. Un modo per risolvere questo problema è impostare le variabili di ambiente necessarie (come CLOUDSDK_ACTIVE_CONFIG_NAME) nel file .envrc nella directory radice del progetto.

Configurazioni degli elenchi

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 configurazione è 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 le 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