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. Inoltre, tieni presente che la directory di configurazione
deve essere abilitata alla scrittura.
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 e un elenco completo delle proprietà disponibili e delle sezioni in cui si trovano, esegui gdcloud topic
configurations.
Configurazione predefinita
gcloud CLI inizialmente crea una singola configurazione denominata
default. Puoi impostare le proprietà nella configurazione eseguendo il comando gdcloud
init o gdcloud config set direttamente.
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. La configurazione iniziale default
viene creata per comodità e non è obbligatoria. Puoi
assegnare a questa e a qualsiasi 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 NAME
Dopo averla creata, devi attivare la nuova configurazione per poterla utilizzare.
Attivare una configurazione
Solo una delle tue configurazioni multiple può essere attiva in un determinato momento. La configurazione attiva è quella 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:
gdcloud config configurations activate NAME
gdcloud config list mostra sempre le proprietà nella configurazione attiva.
Per modificare la configurazione attiva per una singola chiamata di comando, applica
il flag --configuration a 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:
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.