Questa pagina spiega come creare una risorsa di configurazione. Una risorsa di configurazione è un oggetto API che archivia le variabili come coppie chiave-valore. Prima di poter impostare e ottenere le variabili, è necessaria una risorsa di configurazione. Dopo aver creato una risorsa Config, puoi creare variabili arbitrarie da 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 a riga di comando di questa guida, installa lo strumento a riga di comando "gcloud".
- Se vuoi utilizzare gli esempi di API descritti in questa guida, configura l'accesso alle API.
- Leggi Runtime Configurator Fundamentals.
- Attiva 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 necessario:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
dove:
[CONFIG_NAME]è il nome di questa configurazione.- (Facoltativo)
[DESCRIPTION]è la descrizione di questa configurazione.
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.- (Facoltativo)
[DESCRIPTION]è la descrizione di questa configurazione.
gcloud restituisce una risposta, ad esempio:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per un riferimento completo per questo comando gcloud, leggi la documentazione di riferimento di runtime-config configs create.
API
Nell'API REST, effettua 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 ha il seguente aspetto:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
dove:
[PROJECT_ID]è l'ID progetto per questa richiesta.[CONFIG_NAME]è il nome di questo RuntimeConfig.(Facoltativo)
[DESCRIPTION]è la descrizione di questa configurazione.Per saperne di più su questo metodo, consulta la documentazione
configs().create.
Eliminazione di una risorsa RuntimeConfig
L'eliminazione di una risorsa RuntimeConfig elimina tutte le risorse contenute da quella risorsa, incluse tutte le variabili e i camerieri.
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 eseguire 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 a:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per il riferimento completo su gcloud, leggi la documentazione di riferimento di runtime-config configs delete.
API
Nell'API REST, effettua 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 documentazione
configs().delete.
Passaggi successivi
- Poi, crea alcune variabili e scopri come impostare e ottenere i dati.
- Scopri come impostare uno Watcher su una variabile specifica.
- Crea un Waiter che restituisca quando una variabile raggiunge una condizione di cardinalità.
- Fai riferimento al riferimento v1beta1.
- Consulta Quote per Runtime Configurator.
- Scopri di più su Runtime Configurator.