En esta página se explica cómo crear un recurso Config. Un recurso Config es un objeto de API que almacena variables como pares clave-valor. Necesitas un recurso Config para poder definir y obtener variables. Después de crear un recurso Config, puedes crear variables arbitrarias que puedes usar para almacenar datos.
Para obtener más información sobre las configuraciones, las variables y el servicio Runtime Configurator, consulta el artículo Fundamentos de Runtime Configurator.
Antes de empezar
- Si quieres usar los ejemplos de línea de comandos de esta guía, instala la herramienta de línea de comandos`gcloud`.
- Si quieres usar los ejemplos de API de esta guía, configura el acceso a la API.
- Consulta el artículo Fundamentos de Runtime Configurator.
- Habilita la API Runtime Configurator.
Crear una configuración
Puedes crear un recurso Config con Deployment Manager, la gcloud
herramienta de línea de comandos o directamente con la API Runtime Configurator.
Deployment Manager
Para crear una configuración en Deployment Manager, especifica el tipo RuntimeConfig:
runtimeconfig.v1beta1.config
En el properties
del recurso, proporciona el name
y otras propiedades opcionales si quieres:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
donde:
[CONFIG_NAME]
es el nombre de esta configuración.[DESCRIPTION]
es la descripción de esta configuración (opcional).
gcloud
Con Google Cloud CLI, usa el comando gcloud beta runtime-config configs create
:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
donde:
[CONFIG_NAME]
es el nombre de esta configuración.[DESCRIPTION]
es la descripción de esta configuración (opcional).
gcloud
devuelve una respuesta como la siguiente:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para obtener una referencia completa de este comando gcloud
, consulta la documentación de referencia de runtime-config configs create
.
API
En la API REST, haz una solicitud POST
al siguiente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
donde [PROJECT_ID]
es el ID del proyecto de esta solicitud. La carga útil de la solicitud tiene este aspecto:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
donde:
[PROJECT_ID]
es el ID del proyecto de esta solicitud.[CONFIG_NAME]
es el nombre de este RuntimeConfig.[DESCRIPTION]
es la descripción de esta configuración (opcional).Para obtener más información sobre este método, consulta la documentación de
configs().create
.
Eliminar un recurso RuntimeConfig
Si eliminas un recurso RuntimeConfig, se eliminarán todos los recursos que contenga, incluidas todas las variables y los elementos de espera.
Deployment Manager
Elimina un recurso RuntimeConfig que forma parte de una implementación mediante uno de los siguientes métodos:
- Actualiza la implementación para omitir la configuración y volver a implementar la implementación.
- Elimina la implementación y los recursos que contiene.
gcloud
Con Google Cloud CLI, usa el comando gcloud beta runtime-config configs delete
:
gcloud beta runtime-config configs delete [CONFIG_NAME]
donde [CONFIG_NAME]
es el nombre del objeto de configuración.
La CLI de gcloud devuelve una respuesta como la siguiente:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para ver la referencia completa de gcloud
, consulta la runtime-config configs delete
documentación de referencia.
API
En la API REST, haz una solicitud DELETE
al siguiente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
donde:
[PROJECT_ID]
es el ID del proyecto de esta solicitud.[CONFIG_NAME]
es el nombre de esta configuración.Para obtener más información sobre este método, consulta la documentación de
configs().delete
.
Siguientes pasos
- A continuación, crea algunas variables y consulta cómo definir y obtener datos.
- Consulta cómo definir un observador en una variable específica.
- Crea un recurso de espera que se devuelva cuando una variable alcance una condición de cardinalidad.
- Consulta la referencia de v1beta1.
- Consulta las cuotas de Runtime Configurator.
- Consulta información sobre Runtime Configurator.