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 avere una risorsa Config. Dopo aver creato una risorsa Config, puoi creare variabili arbitrarie che puoi utilizzare per archiviare i dati.
Per saperne di più sulle configurazioni, sulle 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 alle API.
- Leggi Concetti fondamentali di Runtime Configurator.
- 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
Nelle properties della risorsa, fornisci il 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 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 (facoltativa).
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 gcloud comando, consulta 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 della 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 questo RuntimeConfig.[DESCRIPTION]è la descrizione di questa configurazione (facoltativa).Per saperne di più su questo metodo, consulta la
configs().createdocumentazione.
Eliminazione di una risorsa RuntimeConfig
L'eliminazione di una risorsa RuntimeConfig elimina tutte le risorse contenute nella 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 in modo da omettere la configurazione e rieseguire 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 a gcloud, consulta la documentazione di riferimento 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().deletedocumentazione.
Passaggi successivi
- Poi, crea alcune variabili e scopri come impostare e recuperare i dati.
- Scopri come impostare un watcher su una variabile specifica.
- Crea un waiter che restituisce un valore quando una variabile raggiunge una condizione di cardinalità.
- Consulta il riferimento v1beta1.
- Consulta le quote per Runtime Configurator.
- Scopri di più su Runtime Configurator.