Faça a gestão das configurações da CLI gdcloud

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.

Sugestão: normalmente, se trabalhar apenas com um projeto, a configuração predefinida denominada default é suficiente. Para saber como definir propriedades numa configuração para definir definições por organização ou por projeto, como o URL da consola da organização ou o projeto a usar, as preferências de acessibilidade, consulte o artigo Gerir propriedades.

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, ~/.config/gdcloud no MacOS e Linux).

Nota: tem de ativar o diretório de configuração para escrita.

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, juntamente com uma lista completa das propriedades disponíveis e as secções em que se encontram, execute gdcloud topic configurations.

Configuração predefinida

A CLI gcloud começa com uma única configuração denominada default. Para definir propriedades na sua configuração, execute o comando gdcloud init ou gdcloud config set.

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. Não existe nada de especial na configuração inicial default. Esta é criada por conveniência. Pode atribuir o nome que quiser a esta e a quaisquer outras configurações.

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 o comando gdcloud config configurations create:

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:

gdcloud config configurations activate NAME

O gdcloud config list mostra sempre as propriedades na sua configuração ativa.

Para alterar a configuração ativa para uma única invocação de comando, pode usar 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:
    insecure_skip_tls_verify: "false"
  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.