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 Compute Engine predefinita, il livello di dettaglio, i report sull'utilizzo, l'ID progetto e un utente o un account 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 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, impostata solo per la scheda Cloud Shell corrente, e non vengono mantenute tra le sessioni.
Se hai più configurazioni, puoi scegliere di passare da una all'altra o di eseguire i 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 Attivazione delle configurazioni di seguito.
Per informazioni sulle configurazioni dalla riga di comando (insieme a un elenco completo delle proprietà disponibili e delle 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 eseguendo direttamente gcloud config set.
Ad esempio, per disattivare la richiesta di conferma per gli script, esegui:
gcloud config set disable_prompts true
Configurazioni multiple
La configurazione default singola è adatta a molti casi d'uso. Tuttavia, puoi anche creare configurazioni aggiuntive e passare da una all'altra in base alle tue esigenze utilizzando gcloud config configurations activate.
La configurazione iniziale di default non ha nulla di speciale, viene creata per comodità. Puoi assegnare a questa e alle altre configurazioni il nome che preferisci.
Più configurazioni 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.
- Utilizza più account di autorizzazione
- Eseguire 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 utilizzare la nuova configurazione, devi attivarla dopo la creazione.
Attivazione di una configurazione
Può essere attiva una sola delle tue configurazioni alla volta. La configurazione attiva è quella le cui proprietà regolano 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à della 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 corrente, puoi impostare la variabile di ambiente CLOUDSDK_ACTIVE_CONFIG_NAME sul nome della configurazione che vuoi utilizzare.
Automazione del cambio di configurazione
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 root del progetto.
Configurazioni della scheda
Per elencare le configurazioni nell'installazione di gcloud CLI, esegui gcloud config configurations list:
gcloud config configurations list
gcloud CLI 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
- Per saperne di più sulle proprietà, leggi Proprietà di gcloud CLI.