Gerenciando propriedades da CLI do gcloud

Propriedades são configurações que controlam o comportamento do gcloud CLI.

Você pode usar propriedades para definir uma configuração por produto ou serviço, como a conta usada pela CLI do gcloud 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 verificações automáticas de atualização de componentes da CLI do gcloud. Propriedades também podem ser usadas para definir preferências da CLI do gcloud, como nível de detalhamento e configuração de prompt para comandos da CLI do gcloud.

Propriedades e sinalizadores

A CLI do gcloud suporta alguns sinalizadores globais e sinalizadores de comando que têm o mesmo efeito que as propriedades da CLI do gcloud. Por exemplo, a CLI do gcloud suporta tanto o sinalizador --project quanto a propriedade project . As propriedades permitem manter as mesmas configurações em todas as execuções de comando, enquanto os sinalizadores afetam o comportamento do comando a cada invocação. Observe que os sinalizadores substituem as propriedades quando ambos são definidos.

Configurações

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

Listagem de imóveis

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

gcloud config list

A CLI do 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

Configurando propriedades

Para definir uma propriedade na configuração ativa, execute gcloud config set . O exemplo a seguir define a propriedade project , onde PROJECT_ID é o ID exclusivo do seu projeto.

gcloud config set project PROJECT_ID

Para definir propriedades que não estão na seção de propriedades core , você deve especificar a seção seguida por uma barra antes do nome da propriedade. O exemplo a seguir define o nome da zona como us-east1-b .

gcloud config set compute/zone us-east1-b

Definir propriedades usando variáveis ​​de ambiente

Você também pode definir propriedades usando variáveis ​​de ambiente. Cada propriedade possui uma variável de ambiente correspondente que pode ser usada para defini-la. O nome da variável de ambiente segue o padrão CLOUDSDK_SECTION_NAME_PROPERTY_NAME . Por exemplo, você pode definir as propriedades core/project e compute/zone da seguinte forma:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Propriedades desativadas

Para remover a definiçã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.

O que vem a seguir