操作场景

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

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

配置项价值如下：

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

前提条件

已创建集群和节点资源，具体操作请参见购买CCE集群。若已有集群和节点资源，无需重复操作。

操作步骤

1. 登录CCE控制台，在左侧导航栏中选择“配置中心 > 配置项（ConfigMap）”，单击“创建配置项”。
2. 您可以直接创建配置项或基于YAML来创建。若希望通过YAML创建，请跳转至4。
3. 方式一：直接创建配置项。
   参照表1设置新增配置参数。

   表1 新建配置参数说明

   参数	参数说明
   配置名称	新建的配置名称，同一个命名空间里命名必须唯一。
   所属集群	使用新建配置的集群。
   集群命名空间	新建配置所在的命名空间。若不选择，默认配置为default。
   描述	配置项的描述信息。
   配置数据	工作负载配置的数据可以在容器中使用，或被用来存储配置数据。其中，“键”代表文件名；“值”代表文件中的内容。 单击“添加更多配置数据” 。 输入键、值。
   配置标签	标签以Key/value键值对的形式附加到各种对象上（如工作负载、节点、服务等）。 标签定义了这些对象的可识别属性，用来对它们进行管理和选择。 单击“添加标签” 。 输入键、值。

4. 方式二：基于YAML创建配置项。
   

   若需要通过上传文件的方式创建资源，请确保资源描述文件已创建。CCE支持yaml格式，详细请参见ConfigMap配置项要求。

   请单击界面右侧的“YAML创建”。

   • 方式一：导入编排文件。

     单击“添加文件”，导入格式为YAML的文件。编排内容中可直接展示编排内容。

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

     在编排内容区域框中，输入YAML文件内容。

5. 配置完成后，单击“创建”。

   工作负载配置列表中会出现新创建的工作负载配置。

ConfigMap配置项要求

ConfigMap资源文件支持yaml文件格式，且文件大小不得超过2MB。

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

使用kubectl创建配置项

1. 请参见通过kubectl或web-terminal插件操作CCE集群配置kubectl命令。
2. 创建并编辑cce-configmap.yaml文件。

   vi cce-configmap.yaml

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cce-configmap
   data:
     SPECIAL_LEVEL: Hello
     SPECIAL_TYPE: CCE

3. 创建配置项。

   kubectl create -f cce-configmap.yaml

   kubectl get cm

   NAME               DATA            AGE
   cce-configmap      3               3h
   cce-configmap1     3               7m

相关操作