Como gerenciar configurações do SDK

O que é uma configuração?

Uma configuração é um conjunto nomeado de propriedades do SDK. Essas propriedades são pares de chave-valor que controlam o comportamento da ferramenta de linha de comando gcloud e de outras ferramentas do SDK.

As propriedades comumente armazenadas nas configurações incluem a zona padrão do Google Compute Engine, o nível de detalhamento, o relatório de uso, o ID do projeto e um usuário ativo ou conta de serviço. As configurações permitem que você defina e ative essas e outras configurações como um grupo.

Se você tiver várias configurações, é possível optar por alternar entre elas ou executar comandos usando uma configuração específica, com a ajuda da sinalização --configuration. Para saber mais sobre como mudar as configurações, consulte a seção abaixo sobre Como ativar configurações.

Para ler sobre configurações da linha de comando, junto com uma lista completa de propriedades disponíveis, execute gcloud topic configurations.

Configuração padrão

O SDK inicia com uma única configuração chamada default. É possível definir propriedades em sua configuração executando o comando gcloud init ou executando diretamente gcloud config set.

Por exemplo, para desativar a solicitação de scripts, execute:

gcloud config set disable_prompts true

Várias configurações

A única configuração default é adequada para muitos casos de uso. No entanto, também é possível criar outras configurações e alternar entre elas conforme necessário usando gcloud config configurations activate. Não há nada de especial em relação à configuração inicial default. Ela é criada apenas como uma conveniência. É possível nomear essa e qualquer outra configuração conforme sua preferência.

Várias configurações são úteis se você quiser:

  • usar vários projetos: é possível criar uma configuração separada para cada projeto e alternar entre eles conforme necessário.
  • usar várias contas de autorização;
  • executar tarefas geralmente independentes: por exemplo, é possível usar uma configuração para trabalhar em um aplicativo do Google App Engine em um projeto e gerenciar instâncias não relacionadas do Compute Engine em outro.

Como criar uma configuração

Para criar uma configuração, execute gcloud config configurations create:

gcloud config configurations create [NAME]

Você precisa ativar a nova configuração depois da criação para usá-la.

Como ativar uma configuração

Apenas uma das diversas configurações pode estar ativa em um determinado momento. As propriedades da configuração ativa controlam o comportamento das ferramentas do SDK.

Para ativar uma nova configuração ou alternar para uma nova configuração ativa, execute: gcloud config configurations activate:

gcloud config configurations activate [NAME]

gcloud config list sempre exibirá as propriedades na sua configuração ativa.

Para alterar a configuração ativa de uma única invocação de comando, use a sinalização --configuration em qualquer comando da CLI da gcloud:

gcloud auth list --configuration=[CONFIGURATION_NAME]

Para alterar a configuração ativa para todos os comandos do terminal atual, defina a variável de ambiente CLOUDSDK_ACTIVE_CONFIG_NAME com o nome da configuração que quiser usar.

Como automatizar a alternância de configurações

Para que as alterações de configuração ocorram sem interrupções, use a ferramenta direnv e a ferramenta ondir (páginas em inglês) para intercalar as configurações automaticamente ao alternar os diretórios de trabalho. Uma maneira de fazer isso é definir as variáveis de ambiente necessárias, como a CLOUDSDK_ACTIVE_CONFIG_NAME, no arquivo .envrc no diretório raiz do seu projeto.

Como listar configurações

Para listar as configurações na instalação do SDK do Cloud, execute gcloud config configurations list:

gcloud config configurations list

A CLI da gcloud lista as configurações e mostra qual delas está ativa no momento:

    NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
    default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
    project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
    project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Como definir propriedades de configuração

Para definir e remover as propriedades da configuração ativa, execute gcloud config set e gcloud config unset:

gcloud config set project [PROJECT]
    gcloud config unset disable_usage_reporting

Como visualizar propriedades de configuração

Para visualizar as propriedades em uma configuração, execute: gcloud config configurations describe:

gcloud config configurations describe [NAME]

Ou para ver as propriedades na configuração ativa:

gcloud config list

A CLI da gcloud imprime as propriedades de configuração:

    is_active: false
    name: default
    properties:
      compute:
        region: us-east1
        zone: us-east1-b
      core:
        account: user@google.com
        project: example-project

Como excluir uma configuração

Para excluir uma configuração, execute: gcloud config configurations delete:

gcloud config configurations delete [NAME]

Não é possível excluir a configuração ativa. Use gcloud config configurations activate, se necessário, para alternar para outra configuração antes da exclusão.

A seguir