Como gerenciar propriedades do SDK do Cloud

As propriedades são configurações que regem o comportamento da ferramenta de linha de comando gcloud e outras ferramentas do SDK do Cloud.

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

Propriedades e sinalizações

A ferramenta gcloud é compatível com algumas sinalizações globais e sinalizações de comando que têm o mesmo efeito que as propriedades do SDK do Cloud. Por exemplo, a ferramenta gcloud aceita 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 do Cloud. A ferramenta gcloud usa uma configuração chamada default como a configuração ativa inicial. O default é adequado para a maioria dos casos de uso. No entanto, você também pode criar mais configurações e alterná-las conforme necessário.

Como listar propriedades

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

gcloud config list

A ferramenta 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 definir 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 usando variáveis de ambiente

Também é possível definir propriedades usando 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