Esta página explica como criar um recurso Config. Um recurso Config é um objeto API que armazena variáveis como pares de chave-valor. Precisa de um recurso de configuração antes de poder definir e obter variáveis. Depois de criar um recurso Config, pode criar variáveis arbitrárias que pode usar para armazenar dados.
Para saber mais acerca das configurações, das variáveis e do serviço Runtime Configurator, consulte o artigo Fundamentos do Runtime Configurator.
Antes de começar
- Se quiser usar os exemplos de linhas de comando neste guia, instale a ferramenta de linhas de comando`gcloud`.
- Se quiser usar os exemplos de API neste guia, configure o acesso à API.
- Leia o artigo Fundamentos do Runtime Configurator.
- Ative a API Runtime Configurator.
Criar uma configuração
Pode criar um recurso Config com o Deployment Manager, a gcloud
ferramenta de linha de comandos ou diretamente através da API Runtime Configurator.
Deployment Manager
Para criar uma configuração no Deployment Manager, especifique o tipo RuntimeConfig:
runtimeconfig.v1beta1.config
No properties do recurso, indique o name e outras propriedades opcionais, se quiser:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
where:
[CONFIG_NAME]é o nome desta configuração.[DESCRIPTION]é a descrição desta configuração (opcional).
gcloud
Com a CLI do Google Cloud, use o comando
gcloud beta runtime-config configs create:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
where:
[CONFIG_NAME]é o nome desta configuração.[DESCRIPTION]é a descrição desta configuração (opcional).
gcloud devolve uma resposta como:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para uma referência completa deste comando gcloud, leia a documentação de referência runtime-config configs create.
API
Na API REST, faça um pedido POST ao seguinte URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
em que [PROJECT_ID] é o ID do projeto para este pedido. A carga útil do pedido tem o seguinte aspeto:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
where:
[PROJECT_ID]é o ID do projeto para este pedido.[CONFIG_NAME]é o nome deste RuntimeConfig.[DESCRIPTION]é a descrição desta configuração (opcional).Para saber mais acerca deste método, leia a
configs().createdocumentação.
Eliminar um recurso RuntimeConfig
A eliminação de um recurso RuntimeConfig elimina todos os recursos contidos nesse recurso, incluindo todas as variáveis e os waiters.
Deployment Manager
Elimine um recurso RuntimeConfig que faça parte de uma implementação através de um dos seguintes métodos:
- Atualize a implementação para omitir a configuração e reimplementar a implementação.
- Eliminar a implementação e os recursos que contém.
gcloud
Com a CLI do Google Cloud, use o comando:gcloud beta runtime-config configs delete
gcloud beta runtime-config configs delete [CONFIG_NAME]
onde [CONFIG_NAME] é o nome do objeto de configuração.
A CLI gcloud devolve uma resposta como:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para ver a gcloud referência completa, leia a runtime-config configs delete
documentação de referência.
API
Na API REST, faça um pedido DELETE ao seguinte URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
where:
[PROJECT_ID]é o ID do projeto para este pedido.[CONFIG_NAME]é o nome desta configuração.Para saber mais acerca deste método, leia a
configs().deletedocumentação.
O que se segue?
- Em seguida, crie algumas variáveis e saiba como definir e obter dados.
- Saiba como definir um observador numa variável específica.
- Crie um Waiter que é devolvido quando uma variável atinge uma condição de cardinalidade.
- Consulte a referência v1beta1.
- Consulte as quotas do Runtime Configurator.
- Saiba mais sobre o Runtime Configurator.