Questa pagina spiega come creare una risorsa Config. Una configurazione è un oggetto API che archivia le variabili come coppie chiave-valore. È necessaria una Risorsa di configurazione prima di poter impostare e ottenere le variabili. Dopo aver creato una configurazione puoi creare variabili arbitrarie da usare 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 presenti 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 la sezione Concetti fondamentali di Runtime Configurator.
- Abilitare 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 (facoltativa).
gcloud
Con Google Cloud CLI, utilizza
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 (facoltativa).
gcloud
restituisce una risposta simile a:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per una documentazione completa di questo comando gcloud
, consulta 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.[DESCRIPTION]
è la descrizione di questa configurazione (facoltativa).Per scoprire di più su questo metodo, consulta la documentazione di
configs().create
.
Eliminazione di una risorsa RuntimeConfig
L'eliminazione di una risorsa RuntimeConfig elimina tutte le risorse contenute al suo interno della risorsa, incluse tutte le variabili e i camerieri.
Deployment Manager
Elimina una risorsa RuntimeConfig che fa parte di un deployment utilizzandone una uno dei seguenti metodi:
- Aggiorna il deployment per omettere la configurazione ed eseguire nuovamente il deployment del deployment.
- Elimina il deployment e le risorse che contiene.
gcloud
Con Google Cloud CLI, utilizza gcloud beta runtime-config configs delete
:
gcloud beta runtime-config configs delete [CONFIG_NAME]
dove [CONFIG_NAME]
è il nome dell'oggetto di configurazione.
L'interfaccia a riga di comando gcloud restituisce una risposta simile alla seguente:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Per il riferimento completo a 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 scoprire di più su questo metodo, consulta la documentazione di
configs().delete
.
Passaggi successivi
- A questo punto, crea alcune variabili e scopri come impostare e recuperare i dati.
- Scopri come impostare un Watcher su una variabile specifica.
- Crea un cameriere che restituisce quando una variabile raggiunge una condizione di cardinalità.
- Consulta il riferimento v1beta1.
- Consulta le quote per Runtime Configurator.
- Scopri di più su Runtime Configurator.