配置项(ConfigMap)是一种用于存储应用所需配置信息的资源类型,内容由用户决定。配置项创建完成后,可在应用中作为文件或者环境变量使用。
场景介绍
配置项允许您将配置文件从镜像中解耦,从而增强应用的可移植性。
配置项价值如下:
- 使用配置项功能可以帮您管理不同环境、不同业务的配置。
- 方便您部署相同应用的不同环境,配置文件支持多版本,方便您进行更新和回滚应用。
- 方便您快速将配置以文件的形式导入到应用中。
前提条件
- 已创建需要使用密钥的集群。
- 创建混合集群,请参考“帮助中心 > 云容器引擎 > 用户指南 > 集群管理 > 创建混合集群”。
- 已创建密钥所在命名空间,请参考“帮助中心 > 云容器引擎 > 用户指南 > 集群管理 > 命名空间”。
创建配置项
1、登录ServiceStage控制台,选择“应用管理 > 应用配置 > 配置项”。
2、单击“创建配置项”。
3、ServiceStage支持“可视化”和“YAML”两种方式来创建配置项。
- 方式一:可视化
参照下表设置新增配置参数,其中带“*”标志的参数为必填参数。
表 新建配置参数说明
参数 | 参数说明 |
---|---|
基本信息 | |
*配置名称 | 新建的配置名称,同一个命名空间里命名必须唯一。 |
*所属集群 | 使用新建配置的集群。 |
*命名空间 | 新建配置所在的命名空间。若不选择,默认配置为default。 |
描述 | 配置项的描述信息。 |
配置数据 | 应用配置的数据可以在应用中使用,或被用来存储配置数据。其中,“键”代表文件名;“值”代表文件中的内容。 单击“添加更多配置数据” 。 输入键、值。 |
配置标签 | 标签以Key/value键值对的形式附加到各种对象上(如应用、节点、服务等)。 标签定义了这些对象的可识别属性,用来对它们进行管理和选择。 单击“添加标签” 。 输入键、值。 |
- 方式二:YAML
说明若需要通过上传文件的方式创建资源,请确保资源描述文件已创建。ServiceStage支持yaml格式,详情请参考ConfigMap配置项要求。
a.在“所属集群”下拉框中,选择相应的集群。
b.(可选)单击“上传文件”,选择已创建的ConfigMap类型资源文件后,单击“打开”。
请上传小于2MB的文件。
c.在“编排内容”中写作或者修改ConfigMap资源文件。
4、配置完成后,单击“创建”。
应用配置列表中会出现新创建的应用配置。
ConfigMap配置项要求
ConfigMap资源文件支持yaml文件格式,且文件大小不得超过2MB。
文件名称为configmap.yaml,配置示例如下:
apiVersion: v1
kind: ConfigMap
metadata:
name: test-configmap
data:
data-1: value-1
data-2: value-2
管理配置项
说明配置项列表中包含系统配置项资源,系统配置项资源不可更新,也不能删除,只能查看。
操作 | 说明 |
---|---|
更新配置项 | 单击目标配置项“操作”列的“更新”。 单击“更新配置”。 |
删除配置项 | 单击目标配置项“操作”列的“删除”,根据系统提示删除配置。 |
批量删除配置项 | 勾选需要删除的配置项。 单击页面左上角的“删除配置项”,根据系统提示删除配置项。 |
查看配置项 | 单击目标配置项“操作”列的“查看YAML”,查看配置项yaml格式文件内容。 |