# 使用ConfigMap配置您的应用程序
本文参考了 Kubernetes Configure a Pod to Use a ConfigMap (opens new window),并有所改写
Kubernetes ConfigMap 可以将配置信息和容器镜像解耦,以使得容器化的应用程序可移植。本文提供了一系列的实例,解释如何通过 Kuboard 创建 ConfigMap 以及如何使用 ConfigMap 中的数据配置 Pod(容器组)。
# 前提条件
您已经安装了 Kubernetes 集群,并且已经在集群中安装了 Kuboard,如果尚未安装,请参考:
# 创建 ConfigMap
提示
Kubernetes 描述了多种 ConfigMap 的创建方法,本文不再复述,请自行参考文档 Configure a Pod to Use a ConfigMap (opens new window)
打开 Kuboard 界面,并点击进入您想要创建 ConfigMap 的 名称空间,切换到 配置中心 / 配置字典 菜单,如下图所示:
点击 配置 --> 创建 ConfigMap 按钮
并填写表单,如下图所示:
点击 保存
ConfigMap 创建成功
# ConfigMap --> 容器的环境变量
在名称空间页面点击 创建工作负载
填写表单如下:
字段名称 填写内容 备注 服务类型 Deployment 服务分层 中间件 服务名称 busybox 副本数量 1 容器名称 busybox 镜像 busybox:1.29 抓取策略 Always Command sleep
3600sleep 和 3600 是两个元素 勾选 环境变量
点击 名值对 可以添加一个环境变量
填写表单:
- 环境名:
ENV_KEY_1
- 值类型:
ConfigMap
- ConfigMap名:
my-config
- ConfigMap Key:
KEY_1
- 环境名:
如下图所示:
点击 保存
点击 应用
点击 完成
在 busybox 的工作负载查看界面,进入容器 busybox 的终端
切换到 /bin/sh 终端
执行命令:
echo $ENV_KEY_1
可查看到输出结果为
value-1
执行命令:
export
可查看到 ENV_KEY_1=
value-1
已经注入到该容器的环境变量中,如下图所示:
# ConfigMap --> 容器的环境变量(ConfigMap的所有名值对)
在名称空间页面点击 创建工作负载
填写表单如下:
字段名称 填写内容 备注 服务类型 Deployment 服务分层 中间件 服务名称 busybox 服务描述 busybox 副本数量 1 容器名称 busybox 镜像 busybox:1.29 抓取策略 Always Command sleep
3600sleep 和 3600 是两个元素 环境变量 my-config 通过 + 配 置 按钮添加 如下图所示:
点击 保存
点击 应用
点击 完成
在 busybox 的工作负载查看界面,进入容器 busybox 的终端
切换到 /bin/sh 终端
执行命令:
echo $KEY_1
可查看到输出结果为
value-1
执行命令:
echo $KEY_2
可查看到输出结果为
value-2
执行命令:
echo $KEY_3
可查看到输出结果为
3600
执行命令:
export
可查看到
KEY_1
KEY_2
KEY_3
已经注入到该容器的环境变量中,如下图所示:
# ConfigMap --> Command 参数
在名称空间页面点击 创建工作负载
填写表单如下:
字段名称 填写内容 备注 服务类型 Deployment 服务分层 中间件 服务名称 busybox 服务描述 busybox 副本数量 1 容器名称 busybox 镜像 busybox:1.29 抓取策略 Always Command /bin/sh -c 'echo ${ENV_KEY_1} ${ENV_KEY_3} ; sleep ${ENV_KEY_3}' 环境变量 ENV_KEY_1 / ENV_KEY_3 选择 ConfigMap
ConfigMap 填写 my-nginx-config
Key 填写 KEY_1
同样的方法添加 ENV_KEY_3如下图所示:
点击 保存
点击 应用
点击 完成
在 busybox 的工作负载查看界面,进入容器 busybox 的日志界面,可查看到该命令输出的结果为
value-1 3600
1如下图所示
# ConfigMap --> 数据卷
创建 ConfigMap 如下图所示:
填写表单:
字段名称 填写内容 备注 名称 my-config KEY_1 value-1 KEY_2 value-2 KEY_3 3600 default_conf 请参考下面的代码块 用来替换 nginx 容器中 /etc/nginx/conf.d/default.conf default_conf 的内容如下:
server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html index.htm; } error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; } }
1
2
3
4
5
6
7
8
9
10
11
12创建 nginx Deployment 如下图所示:
填写 基本信息
填写表单:
字段名称 填写内容 备注 服务类型 Deployment 服务分层 展现层 服务名称 nginx 服务描述 Nginx部署 副本数量 1 填写 容器信息
如下图所示:
填写表单:
字段名称 填写内容 备注 容器名称 nginx 镜像 nginx:1.7.9 抓取策略 Always 填写 存储挂载
如下图所示:
填写表单:
字段名称 填写内容 备注 数据卷名称 任意 可以使用默认生成的名称 数据卷类型 配置字典 ConfigMap my-config KeyToPath : Key default_conf KeyToPath : 子路径 default.conf 挂载到容器 nginx 只读 挂载到容器 nginx : 挂载到容器内路径 /etc/nginx/conf.d/default.conf 挂载到容器 nginx : 子路径 default.conf
点击 保存
点击 应用
点击 完成
进入 sh 终端界面
执行命令
# 切换当前目录 cd /etc/nginx/conf.d # 查看当前目录下的文件 ls # 查看 default.conf 的内容(该文件原本的内容已被 configMap 中的内容替换) cat /default.conf
1
2
3
4
5
6
TIP
- 在这个例子中,我们使用 ConfigMap my-nginx-config 中的 KEY default_conf 中的内容挂载到容器的 /etc/nginx/conf.d/default.conf 路径,以此替换了容器镜像中该路径原来的文件内容;
- 也可以将 ConfigMap 作为一个数据卷(在挂载时不指定数据卷内子路径)挂载到容器,此时 ConfigMap 将映射成一个文件夹,每一个 KEY 是文件夹下的文件名,KEY 对应的 VALUE 是文件当中的内容。
# 注意事项
ConfigMap 作为 Kubernetes API 对象,以 key-value 名值对的形式存储配置信息。如前所述,这些信息可以被 Pod(容器组)以不同的方式使用:
- 将 ConfigMap 中某个 KEY 的 VALUE 作为容器组的环境变量
- 将 ConfigMap 中所有的名值对作为容器组的环境变量
- 在定义容器组的 Command 时,使用 ConfigMap 中 KEY 对应的 VALUE
- 将 ConfigMap 中的信息挂载到数据卷
限制:
- 必须先创建 ConfigMap,才能在容器组中引用 ConfigMap。如果您引用了一个不存在的 ConfigMap,容器组将不能启动;同样的,如果您引用了 ConfigMap 中不存在的 KEY,容器组也将不能启动
- ConfigMap 存在于名称空间当中,只有同一个名称空间下的容器组才能引用