Como criar e excluir recursos RuntimeConfig

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

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 ferramenta de linha de comando gcloud, 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/

em que [PROJECT_ID] é o ID do projeto dessa 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:

gcloud

Com a ferramenta de linha de comando gcloud, 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 ferramenta 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 da configuração.

    Para saber mais sobre esse método, consulte a documentação do configs().delete.

A seguir