Una configurazione è un insieme denominato di proprietà di Google Cloud CLI proprietà. Queste proprietà sono coppie chiave-valore, organizzate in sezioni, che regolano il comportamento di gcloud CLI.
Le proprietà che vengono comunemente archiviate nelle configurazioni includono la zona Compute Engine predefinita, il livello di verbosità, la generazione di report sull'utilizzo, l'ID progetto e un utente o un account di servizio attivo. Le configurazioni ti consentono di definire e abilitare queste e altre impostazioni 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 persistono tra le sessioni.
Se hai più configurazioni, puoi scegliere di passare da una all'altra o eseguire comandi utilizzando una configurazione specifica (con l'aiuto del flag --configuration). Per saperne di più sul cambio di configurazione, consulta
la sezione seguente su Attivazione delle configurazioni.
Per leggere le 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
gcloud init comando o eseguendo
gcloud config set direttamente.
Ad esempio, per disattivare la richiesta di script, esegui:
gcloud config set disable_prompts true
Più configurazioni
La singola configurazione 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.
Non c'è nulla di speciale nella configurazione default iniziale; viene creata per comodità. Puoi assegnare un nome a questa e a qualsiasi configurazione aggiuntiva come preferisci.
Più configurazioni sono utili se vuoi:
- Utilizzare 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
- 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 poter utilizzare la nuova configurazione, devi attivarla dopo la creazione.
Attivazione di una configurazione
Solo una delle tue configurazioni multiple può essere attiva in un determinato momento. 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 mostra 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.
Automatizzazione 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 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.
Elenco delle configurazioni
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 quella 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. Se necessario, utilizza gcloud config configurations activate per passare a un'altra configurazione prima di eliminarla.
Passaggi successivi
- Leggi le proprietà di gcloud CLI per saperne di più sulle proprietà.