Uma configuração é um conjunto denominado de propriedades da CLI do Distributed Cloud. Estas propriedades são pares de chave-valor, organizados em secções, que regem o comportamento da CLI gdcloud.
As propriedades que são normalmente armazenadas nas configurações incluem o URL da consola da organização e o ID do projeto. As configurações permitem-lhe definir e ativar estas e outras definições em conjunto como um grupo.
As configurações são armazenadas no diretório de configuração do utilizador, normalmente, em ~/.config/gdcloud no macOS e Linux. Tenha também em atenção que o diretório de configuração
tem de ter a gravação ativada.
Se tiver várias configurações, pode optar por alternar entre elas ou executar comandos com uma configuração específica com a flag --configuration. Para mais informações sobre como alternar configurações, consulte a secção Ative uma configuração.
Para ler acerca das configurações a partir da linha de comandos e uma lista completa das propriedades disponíveis e das secções em que se encontram, execute gdcloud topic
configurations.
Configuração predefinida
Inicialmente, a CLI gcloud cria uma única configuração denominada
default. Pode definir propriedades na configuração executando o comando gdcloud
init ou executando gdcloud config set diretamente.
Várias configurações
A configuração única default é adequada para muitos exemplos de utilização. No entanto, também pode criar configurações adicionais e alternar entre elas conforme necessário
usando gdcloud config configurations activate. A configuração inicial default
é criada por conveniência e não é necessária para usar. Pode
dar um nome a esta e a quaisquer configurações adicionais como quiser.
As várias configurações são úteis se quiser:
- Use vários projetos: pode criar uma configuração separada para cada projeto e alternar entre eles conforme necessário.
- Use vários URLs da consola da organização.
- Realizar tarefas geralmente independentes: por exemplo, pode usar uma configuração para trabalhar no serviço A num projeto e gerir um serviço B não relacionado noutro projeto.
Crie uma configuração
Para criar uma configuração, execute:
gdcloud config configurations create NAME
Tem de ativar a nova configuração após a criação para a usar.
Ative uma configuração
Apenas uma das suas várias configurações pode estar ativa num determinado momento. A configuração ativa é a configuração cujas propriedades regem o comportamento da CLI gcloud.
Para ativar uma nova configuração ou mudar para uma nova configuração ativa, execute o seguinte comando:
gdcloud config configurations activate NAME
O gdcloud config list apresenta sempre as propriedades na sua configuração ativa.
Para alterar a configuração ativa para uma única invocação de comando, aplique a flag --configuration para qualquer comando da CLI gcloud:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Configurações da lista
Para listar as configurações na CLI gdcloud, execute o seguinte comando:
gdcloud config configurations list
A CLI gdcloud apresenta as configurações e mostra qual configuração está ativa:
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
Definir propriedades de configuração
Para definir e anular a definição das propriedades na configuração ativa, execute:
gdcloud config set project PROJECT
Ver propriedades de configuração
Para ver as propriedades numa configuração, execute o seguinte comando:
gdcloud config configurations describe NAME
A CLI gcloud imprime as propriedades de configuração:
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
Para ver as propriedades na configuração ativa, execute:
gdcloud config list
Elimine uma configuração
Para eliminar uma configuração, execute o seguinte comando:
gdcloud config configurations delete NAME
Não é possível eliminar uma configuração ativa. Para mudar para outra configuração
antes de eliminar, use gdcloud config configurations activate, se necessário.