更新时间:2024-04-15 GMT+08:00

创建配置项

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

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

配置项价值如下:

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

创建配置项

  1. 登录集群控制台,单击左侧导航栏的配置与密钥,选择“配置项”页签。您还可以直接创建配置项或基于YAML来创建,若希望通过YAML创建,请跳转至4
  2. 选择需要创建配置项的命名空间。
  3. 直接创建配置项。单击“创建配置项”。

    参照表1设置新增配置参数。
    表1 新建配置参数说明

    参数

    参数说明

    名称

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

    命名空间

    新建配置项所在的命名空间,默认为当前查看的命名空间。

    描述

    配置项的描述信息。

    配置项数据

    工作负载配置的数据可以在容器中使用,或被用来存储配置数据。

    单击 ,输入键、值。其中,“键”代表配置名;“值”代表配置内容。

    配置标签

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

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

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

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

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

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

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

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

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

  5. 配置完成后,单击“确定”。

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

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. 单击“是”进行确认。