# 创建配置项
配置项（ConfigMap）是一种用于存储工作负载所需配置信息的资源类型，内容由用户决定。配置项创建完成后，可在容器工作负载中作为文件或者环境变量使用。
配置项允许您将配置文件从容器镜像中解耦，从而增强容器工作负载的可移植性。
配置项价值如下：
- 使用配置项功能可以帮您管理不同环境、不同业务的配置。
- 方便您部署相同工作负载的不同环境，配置文件支持多版本，方便您进行更新和回滚工作负载。
- 方便您快速将您的配置以文件的形式导入到容器中。
#### 创建配置项
1. 登录[UCS控制台](https://console.huaweicloud.com/ucs/?#/aether/dashboard)，进入集群页面。
2. 单击左侧导航栏的"配置项与密钥"，选择"配置项"页签。您还可以直接创建配置项或基于YAML来创建，若希望通过YAML创建，请跳转至[5]。
3. 选择需要创建配置项的命名空间。
4. 直接创建配置项。单击"创建配置项"。 
   参照[表1]设置新增配置参数。
    表1新建配置参数说明 
   | 参数    | 参数说明                                                                                                                                                                                                                                                                                                                        |
   |:---|:---|
   | 名称    | 新建的配置项名称，同一个命名空间里命名必须唯一。                                                                                                                                                                                                                                                                                                    |
   | 命名空间  | 新建配置项所在的命名空间，默认为当前查看的命名空间。                                                                                                                                                                                                                                                                                                  |
   | 描述    | 配置项的描述信息。                                                                                                                                                                                                                                                                                                                   |
   | 配置项数据 | 工作负载配置的数据可以在容器中使用，或被用来存储配置数据。 单击![](https://support.huaweicloud.com/usermanual-ucs/zh-cn_image_0000002069472218.png "点击放大") ，输入键、值。其中，"键"代表配置名；"值"代表配置内容。 说明： 配置项可用于创建工作负载存储卷和设置工作负载环境变量，设置工作负载环境变量时，该配置项数据不可为空。                 |
   | 配置标签  | 标签以Key/value键值对的形式附加到各种对象上（如工作负载、节点、服务等）。 标签定义了这些对象的可识别属性，用来对它们进行管理和选择。 1. 输入标签键、值。  2. 单击"确认添加" 。   |
      
   
   
5. 基于YAML创建配置项。在创建配置项页面右侧单击"YAML创建"。
   
   ![](https://support.huaweicloud.com/usermanual-ucs/public_sys-resources/note_3.0-zh-cn.png)
   若需要通过上传文件的方式创建资源，请确保资源描述文件已创建。支持json或yaml格式，详细请参见[ConfigMap资源文件配置说明]。
   您可以导入或直接编写文件内容，格式为YAML或JSON。
   - 方式一：导入编排文件。 单击"导入"，导入格式为YAML或JSON的文件。编排内容中可直接展示YAML或JSON文件的内容。
     
   
   - 方式二：直接编排内容。 在编排内容区域框中，输入YAML或JSON文件内容。
     
    
   
   
6. 配置完成后，单击"确定"。 
   配置项列表中会出现新创建的配置项。
   
   
 
 #### 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
    namespace: default
  data:
    data-1: "value-1"
    data-2: "value-2"
  ```
  
 
#### 相关操作
通过集群控制台，您还可以执行[表2]中的操作。
 表2相关操作 
| 操作     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|
| 查看详情   | 单击配置项名称即可查看配置项数据详情。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 编辑YAML | 单击配置项名称后的"编辑YAML"，可查看并编辑当前配置项的YAML文件。                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 更新     | 1. 单击配置项名称后的"更新"。  2. 根据[表1]更改信息。  3. 单击"确定"提交已修改的信息。   |
| 删除     | 单击配置项名称后的"删除"，并单击"是"进行确认。                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 批量删除   | 1. 勾选需要删除的配置项。  2. 单击左上角的"批量删除"。  3. 单击"是"进行确认。                                             |