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