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, cree algunas variables y consulte cómo configurar 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.