NOME
gdcloud topic configurations - Supplementary help for named configurations.
DESCRIÇÃO
As propriedades da CLI gcloud podem ser armazenadas em configurações com nome, que são coleções de pares de chave-valor que influenciam o comportamento da CLI gcloud.
As configurações com nome são úteis se gerir mais do que um projeto ou uma organização.
As propriedades armazenadas habitualmente nas configurações incluem o URL da consola da organização e o ID do projeto. As configurações permitem-lhe definir e ativar estas e outras definições em conjunto como um grupo.
Os dados de configuração são armazenados em $HOME/.config/gdcloud/.
As configurações são especialmente úteis se
+ Trabalhar com vários projetos. Pode criar uma configuração separada para cada projeto.
- Usar vários URLs da consola da organização.
* Realizar tarefas geralmente independentes. Por exemplo, pode usar uma configuração para trabalhar no serviço de armazenamento de objetos num projeto e gerir um serviço não relacionado noutro projeto.
As informações da propriedade armazenadas em configurações com nome são legíveis por todos os comandos da CLI gdcloud. Para definir as propriedades, use o comando gdcloud config set.
Crie configurações
As configurações com nome podem ser definidas pelos utilizadores ou incorporadas na CLI gdcloud.
As configurações definidas pelo utilizador têm nomes em minúsculas, como johndoe, default, jeff-staging ou foo2. Estes são definidos pela seguinte expressão regular ^[a-z][-a-z0-9]*$.
Para criar uma nova configuração, execute o comando
gdcloud init
Este guia explica como configurar a sua primeira configuração com nome, criar uma nova configuração com nome ou reinicializar uma configuração com nome existente. Tenha em atenção que a reinicialização de uma configuração existente remove todas as respetivas propriedades existentes.
Para criar uma nova configuração vazia, execute o seguinte comando:
gdcloud config configurations create [CONFIG_NAME]
Use configurações
A CLI gdcloud deve ter, no máximo, uma configuração ativa que forneça valores de propriedades. As configurações inativas não têm efeito nas execuções da CLI gdcloud. Para ativar uma configuração, execute o comando
gdcloud config configurations activate [CONFIG_NAME]
Para ver e alterar as propriedades da sua configuração ativa, execute o comando
gdcloud config list
gdcloud config set
Além disso, os comandos no grupo gdcloud config configurations permitem-lhe listar, ativar, mudar o nome, descrever e eliminar configurações que podem ou não estar ativas.
Pode ativar uma configuração para uma única invocação de gdcloud através da flag --configuration my-config.
Propriedades disponíveis
accessibility
* screen_reader
* Se estiver definida, a CLI gcloud ativa o leitor de ecrã.
auth
* login_config_cert_path
* Caminho do ficheiro que armazena o certificado de configuração de início de sessão atual.
component_manager
* disable_update_check
* Se estiver definido, a CLI gcloud não procura atualizações automaticamente.
core
* disable_prompts
* Se for Verdadeiro, a resposta predefinida é assumida para todos os comandos do utilizador. No entanto, é apresentado um erro para todos os comandos que requerem a introdução de dados por parte do utilizador.
* format
* Defina o formato para os recursos de saída do comando de impressão. A predefinição é um formato de saída legível por humanos específico do comando. Se forem especificados core/format e --format, --format tem precedência. Os formatos suportados estão limitados a csv, json, table, text e yaml.
* organization_console_url
* URL para a IU/consola da organização atual. Tenha em atenção que deve 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 único para os utilizadores.
* s3_custom_ca_certs_file
* Ficheiro de certificados personalizados para o objeto de armazenamento do S3.
* s3_endpoint
* O URL do objeto S3 consiste em S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. O S3_ENDPOINT é a localização onde se encontra o contentor de armazenamento do S3.
* s3_secret_access_key
* Chave privada do objeto de armazenamento S3 que é usado para assinar pedidos.