Una configurazione è un insieme denominato di proprietà di Distributed 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 archiviate nelle configurazioni includono l'URL della console dell'organizzazione e l'ID progetto. Le configurazioni ti consentono di definire e attivare queste e altre impostazioni insieme come gruppo.
Le configurazioni vengono memorizzate nella directory di configurazione utente (in genere
~/.config/gdcloud su macOS e Linux).
Se hai più configurazioni, puoi scegliere di passare da una all'altra o
eseguire comandi utilizzando una configurazione specifica con il
flag --configuration. Per saperne di più sul cambio di configurazione, consulta la sezione Attivare una configurazione.
Per informazioni sulle configurazioni dalla riga di comando, nonché un elenco completo delle proprietà disponibili e delle sezioni in cui si trovano, esegui gdcloud topic
configurations.
Configurazione predefinita
gcloud CLI inizia con una singola configurazione denominata
default. Per impostare le proprietà nella configurazione, esegui il comando gdcloud
init o gdcloud config set.
Configurazioni multiple
La 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 gdcloud config configurations activate. Non c'è nulla di speciale nella
configurazione iniziale di default, che viene creata per comodità. Puoi
assegnare a questa e a qualsiasi altra configurazione aggiuntiva il nome che preferisci.
Più configurazioni sono utili se vuoi:
- Utilizza più progetti: puoi creare una configurazione separata per ogni progetto e passare da uno all'altro in base alle esigenze.
- Utilizzare più URL della console dell'organizzazione.
- Svolgere attività generalmente indipendenti: ad esempio, puoi utilizzare una configurazione per lavorare sul servizio A in un progetto e gestire un servizio B non correlato in un altro progetto.
Creare una configurazione
Per creare una configurazione, esegui gdcloud config configurations create:
gdcloud config configurations create NAME
Per utilizzarla, devi attivare la nuova configurazione dopo la creazione.
Attivare 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 della gcloud CLI.
Per attivare una nuova configurazione o passare a una nuova configurazione attiva, esegui:
gdcloud config configurations activate:
gdcloud config configurations activate NAME
gdcloud 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 per qualsiasi comando gcloud CLI:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Elenco delle configurazioni
Per elencare le configurazioni in gcloud CLI, esegui:
gdcloud config configurations list
gcloud CLI elenca le configurazioni e mostra quella attiva:
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
Impostazione delle proprietà di configurazione
Per impostare e annullare l'impostazione delle proprietà nella configurazione attiva, esegui:
gdcloud config set project PROJECT
Visualizzazione delle proprietà di configurazione
Per visualizzare le proprietà in una configurazione, esegui:
gdcloud config configurations describe NAME
gcloud CLI stampa le proprietà di configurazione:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
auth:
insecure_skip_tls_verify: "false"
login_config_cert_path: /tmp/root-web-tls-ca.cert
core:
organization_console_url: https://console.example.com
project: example-project
Per visualizzare le proprietà nella configurazione attiva, esegui:
gdcloud config list
Eliminare una configurazione
Per eliminare una configurazione, esegui:
gdcloud config configurations delete NAME
Non puoi eliminare una configurazione attiva. Per passare a un'altra configurazione
prima di eliminare, utilizza gdcloud config configurations activate, se necessario.