Gestione delle configurazioni dell'interfaccia a riga di comando gcloud

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

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

Solo una delle più configurazioni può essere attiva alla volta. 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 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 (come 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

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