Cette page explique comment créer une ressource Configuration. Une ressource Configuration est un objet d'API qui stocke des variables sous la forme de paires valeur/clé. Vous devez disposer d'une ressource Configuration avant de pouvoir définir et obtenir des variables. Une fois que vous avez défini une ressource Configuration, vous pouvez créer des variables arbitraires que vous utiliserez pour stocker des données.
Pour en savoir plus sur les configurations, les variables et le service Runtime Configurator, consultez les principes de base de Runtime Configurator.
Avant de commencer
- Si vous voulez vous servir des exemples de ligne de commande de ce guide, installez l'outil de ligne de commande gcloud.
- Si vous voulez utiliser les exemples d'API de ce guide, configurez l'accès aux API.
- Consultez les principes de base de Runtime Configurator.
- Activez l'API Runtime Configurator.
Créer une ressource Configuration
Vous pouvez créer une ressource de configuration avec Deployment Manager, l'outil de ligne de commande gcloud ou directement avec l'API Runtime Configurator.
Deployment Manager
Pour créer une configuration dans Deployment Manager, spécifiez le type RuntimeConfig :
runtimeconfig.v1beta1.config
Dans les propriétés (properties) de la ressource, vous devez indiquer son nom (name). Vous pouvez également ajouter d'autres propriétés si vous le souhaitez (ces propriétés sont facultatives) :
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
où :
[CONFIG_NAME]est le nom que vous spécifiez pour la configuration.[DESCRIPTION]est la description de la configuration (cette propriété est facultative).
gcloud
Avec la Google Cloud CLI, utilisez la commande gcloud beta runtime-config configs create :
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
où :
[CONFIG_NAME]est le nom que vous spécifiez pour la configuration.[DESCRIPTION]est la description de la configuration (cette propriété est facultative).
gcloud renvoie une réponse semblable à ce qui suit :
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Pour en savoir plus sur cette commande gcloud, consultez la documentation de référence sur runtime-config configs create.
API
Dans l'API REST, envoyez une requête POST à l'adresse URI suivante :
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
Ici, [PROJECT_ID] est l'ID du projet concerné par cette requête. La charge utile de la requête ressemble à ceci :
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
où :
[PROJECT_ID]est l'ID de projet de cette requête.[CONFIG_NAME]est le nom de la configuration RuntimeConfig.[DESCRIPTION]est la description de la configuration (cette propriété est facultative).Pour en savoir plus sur cette méthode, consultez la documentation sur
configs().create.
Supprimer une ressource RuntimeConfig
La suppression d'une ressource RuntimeConfig entraîne celle de toutes les ressources qu'elle contient, y compris les variables et les services de veille.
Deployment Manager
Supprimez une ressource RuntimeConfig faisant partie d'un déploiement à l'aide de l'une des méthodes suivantes :
- Mettez à jour le déploiement pour qu'il omette la configuration et redéployez l'application.
- Supprimez le déploiement et les ressources qu'il contient.
gcloud
Avec Google Cloud CLI, utilisez la commande gcloud beta runtime-config configs delete :
gcloud beta runtime-config configs delete [CONFIG_NAME]
Ici, [CONFIG_NAME] est le nom de l'objet Configuration.
La CLI gcloud renvoie une réponse semblable à celle-ci :
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Pour en savoir plus sur gcloud, consultez la documentation de référence sur runtime-config configs delete.
API
Dans l'API REST, envoyez une requête DELETE à l'adresse URI suivante :
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
où :
[PROJECT_ID]est l'ID de projet de cette requête.[CONFIG_NAME]est le nom de la configuration.Pour en savoir plus sur cette méthode, consultez la documentation sur
configs().delete.
Étape suivante
- Créer des variables et apprendre à définir et obtenir des données.
- Apprendre à définir un observateur sur une variable spécifique.
- Créez un service de veille qui renvoie une réponse dans le cas où une variable atteint une condition de cardinalité.
- Consulter la référence v1beta1
- Consulter la section Quotas pour Runtime Configurator.
- En savoir plus sur Runtime Configurator