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?
- Leia as configurações da CLI gcloud para saber mais sobre as configurações.