Auf dieser Seite wird erklärt, wie Sie eine Config-Ressource erstellen. Eine Config-Ressource ist ein API-Objekt, das Variablen als Schlüssel/Wert-Paare speichert. Sie benötigen eine Config-Ressource, bevor Sie Variablen festlegen und abrufen können. Nachdem Sie eine Config-Ressource erstellt haben, können Sie beliebige Variablen erstellen, die Sie zur Speicherung von Daten nutzen können.
Weitere Informationen über Variablen und den Runtime Configurator-Dienst erhalten Sie unter Grundlagen des Runtime Configurators.
Hinweis
- Wenn Sie die Befehlszeilenbeispiele in dieser Anleitung verwenden möchten, installieren Sie das gcloud-Befehlszeilentool.
- Wenn Sie die API-Beispiele in dieser Anleitung verwenden möchten, richten Sie den API-Zugriff ein.
- Lesen Sie Grundlagen des Runtime Configurators.
- Aktivieren Sie die Runtime Configurator-API.
Konfiguration erstellen
Sie können eine Konfigurationsressource mit Deployment Manager, dem gcloud
-Befehlszeilentool oder direkt mit der Runtime Configurator API erstellen.
Deployment Manager
Geben Sie den RuntimeConfig-Typ an, um eine Konfiguration im Deployment Manager zu erstellen:
runtimeconfig.v1beta1.config
Geben Sie in den properties
der Ressource bei Bedarf den name
und andere optionale Attribute an:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
wobei
[CONFIG_NAME]
ist der Name der Konfiguration.[DESCRIPTION]
ist die Beschreibung dieser Konfiguration (optional).
gcloud
Verwenden Sie in der Google Cloud CLI den Befehl gcloud beta runtime-config configs create
:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
Dabei gilt:
[CONFIG_NAME]
ist der Name der Konfiguration.[DESCRIPTION]
ist die Beschreibung dieser Konfiguration (optional).
gcloud
gibt eine Antwort wie die folgende zurück:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Eine vollständige Referenz zu diesem gcloud
-Befehl finden Sie in der Referenzdokumentation zu runtime-config configs create
.
API
Senden Sie in der REST API eine POST
-Anfrage an den folgenden URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
Dabei ist [PROJECT_ID]
die Projekt-ID für diese Anfrage. Die Nutzlast für diese Anfrage sieht so aus:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
wobei
[PROJECT_ID]
ist die Projekt-ID für diese Anfrage.[CONFIG_NAME]
ist der Name dieser RuntimeConfig.[DESCRIPTION]
ist die Beschreibung dieser Konfiguration (optional).Weitere Informationen zu dieser Methode erhalten Sie in der Dokumentation zu
configs().create
.
RuntimeConfig-Ressource löschen
Wenn Sie eine RuntimeConfig-Ressource löschen, werden alle in dieser Ressource enthaltenen Ressourcen gelöscht, einschließlich aller Variablen und Waiter.
Deployment Manager
Sie können eine RuntimeConfig-Ressource, die Teil einer Bereitstellung ist, mit einer der folgenden Methoden löschen:
- Aktualisieren Sie die Bereitstellung und entfernen Sie die Konfiguration. Führen Sie dann die Bereitstellung noch einmal aus.
- Löschen Sie die Bereitstellung und die darin enthaltenen Ressourcen.
gcloud
Verwenden Sie in der Google Cloud CLI den Befehl gcloud beta runtime-config configs delete
:
gcloud beta runtime-config configs delete [CONFIG_NAME]
Dabei ist [CONFIG_NAME]
der Name des Konfigurationsobjekts.
Die gcloud-Befehlszeile gibt eine Antwort wie diese zurück:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Die vollständige gcloud
-Referenz finden Sie in der Referenzdokumentation zu runtime-config configs delete
.
API
Senden Sie in der REST API eine DELETE
-Anfrage an den folgenden URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
wobei
[PROJECT_ID]
ist die Projekt-ID für diese Anfrage.[CONFIG_NAME]
ist der Name dieser Konfiguration.Weitere Informationen zu dieser Methode erhalten Sie in der Dokumentation zu
configs().delete
.
Nächste Schritte
- Erstellen Sie als Nächstes einige Variablen und lernen Sie, wie man Daten festlegt und abruft.
- Mehr darüber erfahren, wie für einen Watcher eine bestimmte Variable festgelegt wird
- Mehr über das Erstellen eines Waiters erfahren, der einen Wert zurückgibt, wenn eine Variable eine Kardinalitätsbedingung erfüllt
- Mehr erfahren in der v1beta1-Referenz
- Weitere Informationen finden Sie unter Kontingente für Runtime Configurator.
- Runtime Configurator kennenlernen