文档简介:
本节介绍了配置项的用户指南。
操作场景
配置项(ConfigMap )是一种 API 对象,用来将非机密性的数据保存到键值对中。使用时, Pods 可以将其用作环境变量、命令行参数或者存储卷中的配置文件。
配置项允许您将环境配置信息和容器镜像解耦,便于应用配置的修改。
前提条件
已创建CCSE集群,具体操作请参见创建一个集群。若已有CCSE集群,无需重复操作。
操作步骤
创建配置项
方式1:通过界面创建配置项
- 登陆CCSE控制台, 点击左侧导航栏中的集群,进入集群列表页
- 在集群列表中点击需要创建配置项的集群,进入集群管理页面
- 在集群管理页面导航栏中选择配置管理 > 配置项,进入配置项信息页面
- 点击新建,进入新建配置项页面
- 根据实际需求,设置参数。参数说明可参考下表
参数 | 参数说明 |
---|---|
名称 | 新建的配置名称,同一个命名空间里命名必须唯一。 |
标签 | 标签(Labels)是附加到 Kubernetes 对象(比如 Pod、Service、ConfigMap等)上的键值对。标签定义了这些对象的可识别属性,用来对它们进行管理和选择。 1. 点击标签添加一个标签 2. 输入标签名(key)和标签值(value) |
注解 | 注解(Annotation)是附加到Kubernetes 对象(比如 Pod、Service、ConfigMap等)上的键值对注解定义对象的非标识属性。 1. 点击注解添加一个注解 2. 输入注解名(key)和注解值(value) |
内容 | 配置项定义的配置数据,可以挂在到容器中使用,或用来存储配置数据 1. 输入变量名和变量值 2. 也可以导入文件作为配置项(文件名即变量名,文件内容即变量值) |
点击提交,完成创建。
方式2:使用Yaml创建配置项
登陆CCSE控制台, 点击左侧导航栏中的集群,进入集群列表页
在集群列表中点击需要创建配置项的集群,进入集群管理页面
在集群管理页面导航栏中选择配置管理 > 配置项,进入配置项信息页面
点击新建YAML,进入配置项/新增Yaml页面
Yaml编辑窗口提供一个默认的配置项Yaml模板,可参考模板创建需要的配置项
使⽤配置项
⽅式1: 通过挂载数据卷使⽤配置项
- 登陆CCSE控制台, 点击左侧导航栏中的集群,进⼊集群列表⻚
- 在集群列表中点击需要使⽤配置项的集群,进⼊集群管理⻚⾯
- 在集群管理⻚⾯导航栏中选择⼯作负载, 在列表中选择需要创建的⼯作负载,本⽂以⽆状态为例。
- 点击新建,进⼊新建Deployment⻚⾯
- 根据实际需要设置⼯作负载的基本信息(名称、镜像等),并在 ^“^ 数据卷^”^中,点击添加数据卷,选择configMap类型,填写卷名称,并选择添加已有配置项选择已有的配置项
在实例内容器的 ^“^ 挂载点 ^”^ 中,选择挂载数据卷,并添加挂载的容器路径及权限
点击提交,完成创建。
⽅式2:环境变量中使⽤配置项
登陆CCSE控制台, 点击左侧导航栏中的集群,进⼊集群列表⻚
在集群列表中点击需要使⽤配置项的集群,进⼊集群管理⻚⾯
在集群管理⻚⾯导航栏中选择⼯作负载, 在列表中选择需要创建的⼯作负载,本⽂以⽆状态为例。
点击新建,进⼊新建Deployment⻚⾯
根据实际需要设置⼯作负载的基本信息(名称、镜像等),并在 ^“^ 环境变量^”^中,点击新增变量,类型选择configMapKeyRef,并选择已有的配置项,填写环境变量名
点击提交,完成创建。