更新时间:2022-06-17 GMT+08:00

创建配置项

配置项ConfigMap)是一种用于存储工作负载所需配置信息的资源类型,内容由用户决定。配置项创建完成后,可在容器工作负载中作为文件或者环境变量使用。

配置项允许您将配置文件从容器镜像中解耦,从而增强容器工作负载的可移植性。

配置项价值如下:

  • 使用配置项功能可以帮您管理不同环境、不同业务的配置。
  • 方便您部署相同工作负载的不同环境,配置文件支持多版本,方便您进行更新和回滚工作负载。
  • 方便您快速将您的配置以文件的形式导入到容器中。

创建配置项

  1. 登录集群控制台,单击左侧导航栏的配置中心 > 配置项(ConfigMap)。您还可以直接创建配置项或基于YAML来创建,若希望通过YAML创建,请跳转至3
  2. 直接创建配置项。单击“创建配置项”。

    参照表1设置新增配置参数。带“*”号为必填项。
    表1 新建配置参数说明

    参数

    参数说明

    *配置项名称

    新建的配置名称,同一个命名空间里命名必须唯一。

    *集群名称

    选择需要创建配置项的集群。

    *命名空间

    新建配置所在的命名空间。若不选择,默认配置为default。

    描述

    配置项的描述信息。

    配置数据

    工作负载配置的数据可以在容器中使用。其中,“键”代表文件名;“值”代表文件中的内容。

    1. 单击“添加更多配置数据” 。
    2. 输入键、值。

    标签

    标签以Key/value键值对的形式附加到各种对象上(如工作负载、节点、服务等)。

    标签定义了这些对象的可识别属性,用来对它们进行管理和选择。

    1. 单击“添加标签” 。
    2. 输入键、值。

  3. 基于YAML创建配置项。在创建配置项页面右侧单击“YAML创建”

    若需要通过上传文件的方式创建资源,请确保资源描述文件已创建。MCP支持json或yaml格式,详细请参见ConfigMap资源文件配置说明

    您可以导入或直接编写文件内容,格式为YAML或JSON。
    • 方式一:导入编排文件。

      单击“上传YAML”,导入格式为YAML或JSON的文件。编排内容中可直接展示YAML或JSON文件的内容。

    • 方式二:直接编排内容。

      在编排内容区域框中,输入YAML或JSON文件内容。

  4. 配置完成后,单击“创建”。

    配置项列表中会出现新创建的配置项。

ConfigMap资源文件配置说明

ConfigMap资源文件支持json和yaml两种文件格式,且文件大小不得超过2MB。

  • json文件格式

    文件名称为configmap.json,配置示例如下:

    {
      "kind": "ConfigMap",
      "apiVersion": "v1",
      "metadata": {
        "name": "paas-broker-app-017",
        "namespace": "test"
      },
      "data": {
        "context": "{\"applicationComponent\":{\"properties\":{\"custom_spec\":{}},\"node_name\":\"paas-broker-app\",\"stack_id\":\"0177eae1-89d3-cb8a-1f94-c0feb7e91d7b\"},\"softwareComponents\":[{\"properties\":{\"custom_spec\":{}},\"node_name\":\"paas-broker\",\"stack_id\":\"0177eae1-89d3-cb8a-1f94-c0feb7e91d7b\"}]}"
      }
    }
  • yaml文件格式

    文件名称为configmap.yaml,配置示例如下:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: test-configmap
    data:
      data-1: value-1
      data-2: value-2

相关操作

配置项创建完成后,您还可以执行表2中的操作。
表2 其他操作

操作

说明

查看YAML

单击配置项名称后的“YAML”,可查看到当前配置项的YAML文件。

更新

  1. 选择需要更新的配置项名称,单击“更新”。
  2. 根据表1更改信息。
  3. 单击“更新”。

删除

选择要删除的配置项,单击“删除”。

根据系统提示删除。