Una configurazione è un insieme denominato di proprietà di Distributed Cloud CLI. Queste proprietà sono coppie chiave-valore, organizzate in sezioni, che regolano il comportamento della CLI gdcloud.
Le proprietà comunemente archiviate nelle configurazioni includono l'URL della console dell'organizzazione e l'ID progetto. Le configurazioni consentono di definire e abilitare queste e altre impostazioni insieme come gruppo.
Le configurazioni vengono archiviate nella directory di configurazione utente, in genere ~/.config/gdcloud su Linux, $HOME/Library/Application Support/gdcloud su Mac e %AppData%\gdcloud su Windows. Inoltre, tieni presente che la directory di configurazione deve essere abilitata per la scrittura.
Se hai più configurazioni, puoi scegliere di passare da una all'altra o eseguire i comandi utilizzando una configurazione specifica con il flag --configuration. Per ulteriori informazioni sul cambio di configurazione, consulta la
sezione su Attivare una configurazione.
Per leggere le 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
La CLI gdcloud crea inizialmente una singola configurazione denominata default. Puoi impostare le proprietà nella configurazione eseguendo il comando gdcloud
init o gdcloud config set direttamente.
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 gdcloud config configurations activate. La configurazione default iniziale viene creata per comodità e non è obbligatoria. 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ù URL della console dell'organizzazione.
- Eseguire 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
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à regoleranno il comportamento di gdcloud CLI.
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à della configurazione attiva.
Per modificare la configurazione attiva per una singola chiamata di comando, applica il flag --configuration a qualsiasi comando CLI gdcloud:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Elencare le configurazioni
Per elencare le configurazioni nella CLI gdcloud, esegui:
gdcloud config configurations list
gdcloud CLI elenca le configurazioni e mostra quale è 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
Impostare le proprietà di configurazione
Per impostare e annullare l'impostazione delle proprietà nella configurazione attiva, esegui:
gdcloud config set project PROJECT
Visualizzare le proprietà di configurazione
Per visualizzare le proprietà in una configurazione, esegui:
gdcloud config configurations describe NAME
CLI gdcloud stampa le proprietà di configurazione:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
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 dell'eliminazione, utilizza gdcloud config configurations activate, se necessario.