Como gerenciar propriedades de 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. A configuração 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.

Como 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 definir propriedades

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

gcloud config set project [PROJECT]

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

gcloud config set compute/zone us-east1-b

Como cancelar a definição de propriedades

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

gcloud config unset disable_usage_reporting

Tipos de propriedade

Na visualização de listas de propriedades, as propriedades relacionadas do SDK são agrupadas em seções.

Propriedades de core

A seção core contém propriedades de configuração do comando gcloud.

Nome Descrição
account Conta de usuário ou de serviço usada pela CLI da gcloud e outras ferramentas do SDK para autorização.
disable_color Se definido como True, impede que a CLI da gcloud imprima mensagens em cores no terminal.
disable_prompts Se definido como True, suprime prompts de todos os comandos da CLI da gcloud e pressupõe a resposta padrão. Se um comando exigir entrada do usuário e um padrão não puder ser usado, a CLI da gcloud reportará um erro. Equivalente à sinalização --quiet global.
disable_usage_reporting Se definido como True, desativa a coleção de estatísticas anônimas sobre o uso do SDK. Você define esse valor ao instalar o SDK, mas pode alterá-lo a qualquer momento.
log_http Caso definido como True, ativa a gravação de solicitações HTTP e respostas em registros. Caso você queira ver essas mensagens no terminal, ajuste a configuração de detalhamento usando a propriedade verbosity ou a sinalização --verbosity.
project Código do projeto do Cloud Platform atual. É possível modificar esse valor usando a sinalização --project global.
trace_token Token fornecido pelo suporte do Google para encaminhar traces das solicitações de serviço para investigação de problemas.
user_output_enabled Permite a impressão da saída do comando para a saída e o erro padrão no terminal. Se definido como False, a saída será suprimida.
verbosity O detalhamento da geração de registros para comandos da CLI da gcloud. A CLI da gcloud é compatível com os seguintes níveis de detalhamento padrão:
  • debug
  • info
  • warning
  • error
  • critical
  • none
Equivalente ao uso da sinalização --verbosity global.

Propriedades do administrador do componente

Na seção component_manager, há propriedades usadas no gerenciamento de componentes do SDK.

Nome Descrição
component_manager/additional_repositories Lista separada por vírgulas de repositórios adicionais para verificação de componentes. Essa propriedade é gerenciada automaticamente pelos comandos no grupo de comandos gcloud components repositories.
component_manager/disable_update_check Caso seja True, o SDK não verificará automaticamente se há atualizações.

Propriedades do App Engine

Na seção app, há propriedades que especificam o comportamento do comando gcloud app deploy.

Nome Descrição
app/stop_previous_version Caso seja True, interromperá a versão implantada anteriormente durante a implantação de uma nova versão do aplicativo. Caso seja False, a versão anterior precisará ser interrompida manualmente antes da implantação.

Propriedades do Compute Engine

Na seção compute, há propriedades usadas pelos comandos da CLI da gcloud que operam nos recursos do Google Compute Engine.

Nome Descrição
compute/region Região padrão a ser usada no trabalho com recursos do Compute Engine. Esse valor será usado caso a sinalização --region seja obrigatória para um comando da CLI da gcloud, mas não seja fornecida.
compute/zone Zona padrão a ser usada no trabalho com recursos do Compute Engine. Esse valor será usado caso a sinalização --zone seja obrigatória para um comando da CLI da gcloud, mas não seja fornecida.

Propriedades do Kubernetes Engine

A seção container contém propriedades usadas por comandos da CLI do gcloud que operam em clusters do Google Kubernetes Engine.

Nome Descrição
container/cluster Nome do cluster a ser usado por padrão.

Propriedades do proxy de rede

A seção proxy contém propriedades relacionadas ao uso de proxies de rede pelo comando gcloud.

Nome Descrição
proxy/type Tipo de servidor proxy. Os tipos de proxy compatíveis são:
  • http
  • http_no_tunnel
  • socks4
  • socks5
proxy/address Nome do host ou endereço IP do servidor proxy.
proxy/port Porta a ser usada na conexão com o servidor proxy.
proxy/username Nome de usuário a ser usado na conexão com o servidor proxy, caso necessário.
proxy/password Senha a ser usada na conexão com o servidor proxy, caso necessário.
proxy/rdns Se for "True" (padrão), as consultas de DNS não serão realizadas localmente. Em vez disso, elas serão entregues ao proxy para ser resolvidas.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud SDK