Esta página explica como criar o recurso Config, que é um objeto de API que armazena variáveis como pares de chave-valor. Ele é necessário para definir e receber variáveis. Após criá-lo, será possível criar variáveis arbitrárias que podem ser usadas para armazenar dados.
Para saber mais sobre as configurações, as variáveis e o serviço Runtime Configurator, consulte Fundamentos do Runtime Configurator.
Antes de começar
- Para usar os exemplos de linha de comando deste guia, instale a ferramenta de linha de comando "gcloud".
- Para usar os exemplos de API deste guia, configure o acesso de API.
- Leia Noções básicas do Runtime Configurator.
- Ative a Runtime Configurator API.
Criação de config
É possível criar um recurso Config com o Deployment Manager, a ferramenta de linha de comando gcloud ou diretamente usando a API Runtime Configurator.
Deployment Manager
Para criar o config no Deployment Manager, especifique o tipo de RuntimeConfig:
runtimeconfig.v1beta1.config
No properties do recurso, forneça name e outras propriedades opcionais, se quiser:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
onde:
[CONFIG_NAME]é o nome do config;[DESCRIPTION]é a descrição do config (opcional).
gcloud
Com a Google Cloud CLI, use o
comando gcloud beta runtime-config configs create:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
onde:
[CONFIG_NAME]é o nome do config;[DESCRIPTION]é a descrição do config (opcional).
gcloud retorna uma resposta como:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para conseguir uma referência completa deste comando gcloud, consulte a documentação de referência do runtime-config configs create.
API
Na API REST, faça uma solicitação POST para o seguinte URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
[PROJECT_ID] é o ID do projeto desta solicitação. O payload da solicitação tem esta aparência:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
onde:
[PROJECT_ID]é o ID do projeto da solicitação;[CONFIG_NAME]é o nome desse RuntimeConfig;[DESCRIPTION]é a descrição do config (opcional).Para saber mais sobre esse método, consulte a documentação do
configs().create.
Exclusão do recurso RuntimeConfig
A exclusão de um recurso do RuntimeConfig remove todos os recursos incluídos nele, como todas as variáveis e waiters.
Deployment Manager
Exclua um recurso RuntimeConfig que faça parte da implantação usando um dos seguintes métodos:
- Atualizar a implantação para omitir o config e reimplantá-la.
- Excluir a implantação e todos os recursos dela.
gcloud
Com a Google Cloud CLI, use o comando
gcloud beta runtime-config configs delete:
gcloud beta runtime-config configs delete [CONFIG_NAME]
em que [CONFIG_NAME] é o nome do objeto de configuração.
A CLI gcloud retorna uma resposta como:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para a referência completa do gcloud, consulte a documentação de referência do runtime-config configs delete.
API
Na REST API, faça uma solicitação DELETE para o seguinte URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
onde:
[PROJECT_ID]é o ID do projeto da solicitação;[CONFIG_NAME]é o nome desta configuração;Para saber mais sobre esse método, consulte a documentação do
configs().delete.
A seguir
- A seguir, crie algumas variáveis e aprenda como definir e receber dados.
- Saiba como definir um Inspetor em uma variável específica.
- Crie um encarregado que é retornado quando uma variável atinge a condição de cardinalidade.
- Consulte a referência da v1beta1.
- Consulte Cotas do Runtime Configurator.
- Saiba sobre o Runtime Configurator.