NOME
gdcloud topic configurations: ajuda complementar para configurações nomeadas.
DESCRIÇÃO
As propriedades da CLI gdcloud podem ser armazenadas em configurações nomeadas, que são coleções de pares de chave-valor que influenciam o comportamento da CLI gdcloud.
As configurações nomeadas são úteis se você gerencia mais de um projeto ou organização.
As propriedades comumente armazenadas nas configurações incluem o URL do console da organização e o ID do projeto. As configurações permitem que você defina e ative essas e outras configurações como um grupo.
Os dados de configuração são armazenados em $HOME/.config/gdcloud/.
As configurações são especialmente úteis se você
+ Trabalha com vários projetos. É possível criar uma configuração separada para cada projeto.
- Use vários URLs do console da organização.
* Realize tarefas geralmente independentes. Por exemplo, uma configuração pode ser usada para trabalhar no serviço Object Storage em um projeto e gerenciar um serviço não relacionado em outro projeto.
As informações de propriedade armazenadas em configurações nomeadas podem ser lidas por todos os comandos da CLI gdcloud. Para definir as propriedades, use o comando gdcloud config set.
Criar configurações
As configurações nomeadas podem ser definidas pelos usuários ou integradas à CLI gdcloud.
As configurações definidas pelo usuário têm nomes em letras minúsculas, como johndoe, default, jeff-staging ou foo2. Elas são definidas pela seguinte expressão regular: ^[a-z][-a-z0-9]*$.
Para criar uma configuração, execute
gdcloud init
Este guia explica como configurar sua primeira configuração nomeada, criar uma nova configuração nomeada ou reinicializar uma configuração nomeada atual. A reinicialização de uma configuração remove todas as propriedades dela.
Para criar uma configuração vazia, execute
gdcloud config configurations create [CONFIG_NAME]
Usar configurações
A CLI gdcloud precisa ter no máximo uma configuração ativa que forneça valores de propriedade. As configurações inativas não afetam as execuções da CLI gdcloud. Para ativar uma configuração, execute
gdcloud config configurations activate [CONFIG_NAME]
Para ver e mudar as propriedades da configuração ativa, execute
gdcloud config list
gdcloud config set
Além disso, os comandos no grupo gdcloud config configurations permitem listar, ativar, renomear, descrever e excluir configurações que podem ou não estar ativas.
É possível ativar uma configuração para uma única invocação do gdcloud usando a flag --configuration my-config.
Propriedades disponíveis
accessibility
* screen_reader
* Se definido, a CLI gdcloud ativa o leitor de tela.
auth
* login_config_cert_path
* Caminho do arquivo que armazena o certificado da configuração de login atual.
component_manager
* disable_update_check
* Se definido, a CLI gdcloud não verifica automaticamente se há atualizações.
core
* disable_prompts
* Se for "True", a resposta padrão será usada para todos os comandos do usuário. No entanto, para qualquer solicitação que exija entrada do usuário, um erro será gerado.
* format
* Define o formato para imprimir recursos de resposta ao comando. O padrão é um formato de saída legível por humanos específico do comando. Se core/format e --format forem especificados, --format terá precedência. Os formatos aceitos são csv, json, table, text e yaml.
* organization_console_url
* URL da UI/console da organização atual. Ele precisa começar com https //console.. Por exemplo, https //console.org-name.gdch.google.com.
* project
* Nome do projeto atual.
storage
* s3_access_key_id
* ID da chave de acesso do objeto de armazenamento do S3. É um identificador exclusivo para usuários.
* s3_custom_ca_certs_file
* Arquivo de certificados personalizados para o objeto de armazenamento do S3.
* s3_endpoint
* O URL do objeto do S3 consiste em S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. O S3_ENDPOINT é o local onde o bucket de armazenamento do S3 está localizado.
* s3_secret_access_key
* Chave privada do objeto de armazenamento do S3 usado para assinar solicitações.