Questa pagina spiega come creare una risorsa Config. Una risorsa Config è un oggetto API che archivia le variabili come coppie chiave-valore. Prima di poter impostare e recuperare le variabili, devi disporre di una risorsa Config. Dopo aver creato una risorsa Config, puoi creare variabili arbitrarie che puoi utilizzare per archiviare i dati.
Per scoprire di più su configurazioni, variabili e sul servizio Runtime Configurator, consulta Concetti fondamentali di Runtime Configurator.
Prima di iniziare
- Se vuoi utilizzare gli esempi di riga di comando in questa guida, installa lo strumento a riga di comando`gcloud`.
- Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso API.
- Leggi Concetti fondamentali di Runtime Configurator.
- Abilita l'API Runtime Configurator.
Creazione di una configurazione
Puoi creare una risorsa Config con Deployment Manager, lo strumento a riga di comando gcloud
o direttamente utilizzando l'API Runtime Configurator.
Deployment Manager
Per creare una configurazione in Deployment Manager, specifica il tipo RuntimeConfig:
runtimeconfig.v1beta1.config
Nel properties
della risorsa, fornisci name
e altre proprietà facoltative, se vuoi:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
dove:
[CONFIG_NAME]
è il nome di questa configurazione.[DESCRIPTION]
è la descrizione di questa configurazione (facoltativo).
gcloud
Con Google Cloud CLI, utilizza il comando
gcloud beta runtime-config configs create
:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
dove:
[CONFIG_NAME]
è il nome di questa configurazione.[DESCRIPTION]
è la descrizione di questa configurazione (facoltativo).
gcloud
restituisce una risposta simile alla seguente:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per un riferimento completo a questo comando gcloud
, leggi la
runtime-config configs create
documentazione di riferimento.
API
Nell'API REST, invia una richiesta POST
al seguente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
dove [PROJECT_ID]
è l'ID progetto per questa richiesta. Il payload per
la richiesta è simile al seguente:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
dove:
[PROJECT_ID]
è l'ID progetto per questa richiesta.[CONFIG_NAME]
è il nome di questa configurazione RuntimeConfig.[DESCRIPTION]
è la descrizione di questa configurazione (facoltativo).Per saperne di più su questo metodo, consulta la
configs().create
documentazione.
Eliminazione di una risorsa RuntimeConfig
L'eliminazione di una risorsa RuntimeConfig comporta l'eliminazione di tutte le risorse contenute in quella risorsa, incluse tutte le variabili e tutti i waiter.
Deployment Manager
Elimina una risorsa RuntimeConfig che fa parte di un deployment utilizzando uno dei seguenti metodi:
- Aggiorna il deployment per omettere la configurazione ed eseguirne nuovamente il deployment.
- Elimina il deployment e le risorse che contiene.
gcloud
Con Google Cloud CLI, utilizza il comando gcloud beta runtime-config configs delete
:
gcloud beta runtime-config configs delete [CONFIG_NAME]
dove [CONFIG_NAME]
è il nome dell'oggetto di configurazione.
gcloud CLI restituisce una risposta simile alla seguente:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per il riferimento completo di gcloud
, leggi la documentazione di riferimento di runtime-config configs delete
.
API
Nell'API REST, invia una richiesta DELETE
al seguente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
dove:
[PROJECT_ID]
è l'ID progetto per questa richiesta.[CONFIG_NAME]
è il nome di questa configurazione.Per saperne di più su questo metodo, consulta la
configs().delete
documentazione.
Passaggi successivi
- Successivamente, crea alcune variabili e scopri come impostare e recuperare i dati.
- Scopri come impostare un Watcher su una variabile specifica.
- Crea una risorsa waiter che viene restituita quando una variabile raggiunge una condizione di cardinalità.
- Consulta il riferimento v1beta1.
- Consulta le quote per Runtime Configurator.
- Scopri di più su Runtime Configurator.