Como gerenciar propriedades do SDK

O que é uma propriedade?

Propriedades são configurações que regem o comportamento da CLI do gcloud e de outras ferramentas do SDK.

As propriedades podem ser usadas para definir uma configuração por produto ou por serviço, como a conta usada pela CLI da gcloud e outras ferramentas do SDK do Cloud para autorização, a região padrão a ser usada ao trabalhar com recursos do Google Compute Engine ou até mesmo a opção para desativar as atualizações automáticas dos componentes do SDK do Cloud. As propriedades também podem ser usadas para definir as preferências da ferramenta de linha de comando gcloud, como nível de detalhamento e configuração de prompt para os comandos da CLI da gcloud.

Propriedades e sinalizações

A CLI da gcloud é compatível com algumas sinalizações globais e sinalizações de comando que têm o mesmo efeito que as propriedades do SDK. Por exemplo, a CLI da gcloud é compatível com a sinalização --project e a propriedade project. As propriedades permitem que você mantenha as mesmas configurações em várias execuções de comandos, enquanto as sinalizações afetam o comportamento do comando por invocação. As sinalizações substituem as propriedades quando as duas estão definidas.

Configurações

Uma configuração é um conjunto nomeado de propriedades do SDK. A CLI da gcloud usa uma configuração chamada default como a configuração ativa inicial, e default é adequada para a maioria dos casos de uso. No entanto, você também pode criar mais configurações e alterná-las conforme necessário.

Listar propriedades

Para listar as propriedades na configuração ativa, execute gcloud config list:

gcloud config list

A CLI da gcloud retorna a lista de propriedades:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Como configurar propriedades

Para definir uma propriedade na configuração ativa, execute gcloud config set:

gcloud config set project [PROJECT]

Para configurar propriedades que não estão na seção core, é necessário especificar a seção seguida por uma barra antes do nome da propriedade:

gcloud config set compute/zone us-east1-b

Como definir propriedades por meio de variáveis de ambiente

Também é possível definir propriedades por meio de variáveis de ambiente. Cada propriedade tem uma variável de ambiente correspondente que pode ser usada para configurá-la. O nome da variável de ambiente segue o padrão CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Por exemplo, é possível definir as propriedades core/project e compute/zone da seguinte maneira:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Cancelar a definição de propriedades

Para remover a configuração de uma propriedade na configuração ativa, use gcloud config unset:

gcloud config unset disable_usage_reporting

Propriedades disponíveis

A lista de todas as propriedades pode ser encontrada executando gcloud topic configurations ou gcloud config set --help e procurando a seção "Propriedades disponíveis".

A seguir