Gerir propriedades da CLI gcloud

As propriedades são definições que regem o comportamento da CLI gcloud.

Pode usar propriedades para definir uma definição por produto ou por serviço, como a conta usada pela CLI gcloud para autorização, a região predefinida a usar quando trabalha com recursos do Compute Engine ou a opção para desativar as verificações automáticas de atualizações de componentes da CLI gcloud. As propriedades também podem ser usadas para definir preferências da CLI gcloud, como o nível de detalhe e a configuração de comandos da CLI gcloud.

Propriedades e flags

A CLI gcloud suporta algumas flags globais e flags de comando que têm o mesmo efeito que as propriedades da CLI gcloud. Por exemplo, a CLI gcloud suporta a flag --project e a propriedade project. As propriedades permitem-lhe manter as mesmas definições nas execuções de comandos, enquanto as flags afetam o comportamento dos comandos com base em cada invocação. Tenha em atenção que os sinalizadores substituem as propriedades quando ambos estão definidos.

Configurações

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

Propriedades da ficha

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

gcloud config list

A CLI gcloud devolve 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

Definir propriedades

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

gcloud config set project PROJECT_ID

Para definir propriedades que não estão na secção core, tem de especificar a secção seguida de uma barra antes do nome da propriedade. O exemplo seguinte define o nome da zona como us-east1-b.

gcloud config set compute/zone us-east1-b

Definir propriedades através de variáveis de ambiente

Também pode definir propriedades através de variáveis de ambiente. Cada propriedade tem uma variável de ambiente correspondente que pode ser usada para a definir. O nome da variável de ambiente segue o padrão CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Por exemplo, pode definir as propriedades core/project e compute/zone da seguinte forma:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Anular a definição de propriedades

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

gcloud config unset disable_usage_reporting

Propriedades disponíveis

Pode encontrar a lista de todas as propriedades executando gcloud topic configurations ou gcloud config set --help e procurando a secção Propriedades disponíveis.

O que se segue?