创建和删除 RuntimeConfig 资源

本页介绍如何创建配置资源。配置资源是一种 API 对象,可将变量存储为键值对。您必须先拥有配置资源,然后才能设置和获取变量。创建配置资源后,您可以创建用于存储数据的任意变量。

如需详细了解配置、变量和 Runtime Configurator 服务,请参阅 Runtime Configurator 基础知识

准备工作

创建配置

您可以使用 Deployment Manager、gcloud 命令行工具或直接使用 Runtime Configurator API 来创建配置资源。

Deployment Manager

要在 Deployment Manager 中创建配置,请指定 RuntimeConfig 类型:

runtimeconfig.v1beta1.config

在资源的 properties 中,根据需要提供 name 和其他可选属性:

resources:
- name: [CONFIG_NAME]
  type: runtimeconfig.v1beta1.config
  properties:
    config: [CONFIG_NAME]
    description: [DESCRIPTION]

其中:

  • [CONFIG_NAME] 是此配置的名称。
  • [DESCRIPTION] 是此配置的说明(可选)。

gcloud

gcloud 命令行工具中,使用 gcloud beta runtime-config configs create 命令:

gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]

其中:

  • [CONFIG_NAME] 是此配置的名称。
  • [DESCRIPTION] 是此配置的说明(可选)。

gcloud 会返回如下响应:

Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].

如需查看此 gcloud 命令的完整参考文档,请阅读 runtime-config configs create 参考文档。

API

在 REST API 中,向以下 URI 发出 POST 请求:

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/

其中,[PROJECT_ID] 是此请求的项目 ID。此请求的载荷如下所示:

{
   "name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
   "description": "[DESCRIPTION]"

}

其中:

  • [PROJECT_ID] 是此请求的项目 ID。
  • [CONFIG_NAME] 是此 RuntimeConfig 的名称。
  • [DESCRIPTION] 是此配置的说明(可选)。

    要详细了解此方法,请阅读 configs().create 文档。

删除 RuntimeConfig 资源

删除 RuntimeConfig 资源会删除该资源包含的所有资源,包括所有变量和 waiter。

Deployment Manager

使用以下方法之一删除属于部署的 RuntimeConfig 资源:

gcloud

gcloud 命令行工具中,使用 gcloud beta runtime-config configs delete 命令:

gcloud beta runtime-config configs delete [CONFIG_NAME]

其中,[CONFIG_NAME] 是配置对象的名称。

gcloud 工具会返回如下响应:

Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].

如需查看完整的 gcloud 参考文档,请阅读 runtime-config configs delete 参考文档。

API

在 REST API 中,向以下 URI 发出 DELETE 请求:

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]

其中:

  • [PROJECT_ID] 是此请求的项目 ID。
  • [CONFIG_NAME] 是此配置的名称。

    要详细了解此方法,请阅读 configs().delete 文档。

后续步骤