一、Configmap简介
Configmap用于保存配置数据,以键值对的形式存储
Configmap资源提供了向Pod诸如配置数据的方法
旨在让镜像和配置文件解偶,以便实现镜像的可移植性和可复用性
典型的使用场景:
填充环境变量的值
设置容器内的命令行参数
填充卷的配置文件
创建Configmap的方式:
使用字面值创建
使用文件创建
使用目录创建
编写Configmap的yaml文件创建
如何使用Configmap:
通过环境变量的方式直接传递给pod
通过在pod的命令行下运行的方式
作为volume的方式挂载到pod内
二、创建Configmap
使用命令行指定key和value创建
创建:
[root@server1 ~]# kubectl create configmap cm1 --from-literal=key1=value1
configmap/cm1 created
以上命令表示创建一个名称为cm1,key为key1,value为value1的Configmap,也可以在命令后接多个–from-literal以创建多个键值对。
查看创建的Configmap:
[root@server1 ~]# kubectl get cm
NAME DATA AGE
cm1 1 6s
查看详细信息:
[
root@server1 ~]# kubectl describe cm cm1
Name: cm1
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
key1: #键
----
value1 #值
Events: <none>
使用文件创建
使用文件创建Configmap时,key的名称是文件名称,value的值是这个文件的内容:
[root@server1 ~]# kubectl create configmap cm2 --from-file=/etc/resolv.conf
configmap/cm2 created
[root@server1 ~]# kubectl describe cm cm2
Name: cm2
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
resolv.conf: #键
----
nameserver 114.114.114.114 #值
Events: <none>
[root@server1 ~]# cat /etc/resolv.conf #查看文件内容,和value的值相同
nameserver 114.114.114.114
使用目录创建
使用目录创建时,目录中的文件名为key,文件内容是value:
建立测试目录:
[root@server1 ~]# mkdir cm
[root@server1 ~]# cd cm/
[root@server1 cm]# cp /etc/resolv.conf .
[root@server1 cm]# cp /etc/hosts .
创建:
[root@server1 cm]# kubectl create configmap cm3 --from-file=/root/cm
configmap/cm3 created
[root@server1 cm]# kubectl describe cm cm3
Name: cm3
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
hosts:
----
172.25.63.250 foundation63.ilt.example.com
172.25.63.1 server1 reg.westos.org
172.25.63.2 server2
172.25.63.3 server3
172.25.63.4 server4
172.25.63.5 server5
172.25.63.6 server6
172.25.63.7 server7
resolv.conf:
----
nameserver 114.114.114.114
Events: <none>
可以看出目录中的文件名为key,文件内容是value。
编写yaml文件创建
编写Configmap的yaml文件:
[root@server1 cm]# vim cm4.yaml
[root@server1 cm]# cat cm4.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: cm4
data:
db_host: "172.25.63.250"
db_port: "3306"
上述文件表示创建一个名为cm4的ConfigMap,其键值对为data下的内容。
查看:
[root@server1 cm]# kubectl create -f cm4.yaml
configmap/cm4 created
[root@server1 cm]# kubectl get cm
NAME DATA AGE
cm1 1 9m12s
cm2 1 7m24s
cm3 2 5m4s
cm4 2 7s
[root@server1 cm]# kubectl describe cm cm4
Name: cm4
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
db_host:
----
172.25.63.250
db_port:
----
3306
Events: <none>
三、使用Configmap
通过环境变量的方式直接传递给pod
编辑yaml文件:
[root@server1 cm]# vim pod.yaml
[root@server1 cm]# cat pod.yaml
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: pod1
image: busybox
command: ["/bin/sh","-c","env"]
env:
- name: key1
valueFrom:
configMapKeyRef:
name: cm4
key: db_host
- name: key2
valueFrom:
configMapKeyRef:
name: cm4
key: db_port
restartPolicy: Never
上述文件表示运行一个pod输出env信息,在env信息中加入刚才创建的cm4中的键值对,但是键被改为 key1 和 key2.
创建pod:
[root@server1 cm]# kubectl create -f pod.yaml
pod/pod1 created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
pod1 0/1 Completed 0 5s
查看pod的日志可以查看pod内输出的env信息:
[root@server1 cm]# kubectl logs pod1
可以看出将cm4中的值成功导入了pod内。
实验后删除:
[root@server1 cm]# kubectl delete pod pod1
pod "pod1" deleted
接下来再看一个示例:
[root@server1 cm]# vim pod1.yaml
[root@server1 cm]# cat pod1.yaml
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: pod1
image: busybox
command: ["/bin/sh","-c","env"]
envFrom:
- configMapRef:
name: cm4
restartPolicy: Never
上述文件表示直接将cm4中的键值对导入pod的env中,键和值都不做更改:
[root@server1 cm]# kubectl create -f pod1.yaml
pod/pod1 created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
pod1 0/1 Completed 0 57s
查看日志:
[root@server1 cm]# kubectl logs pod1
可以看出导入后键和值都没有更改。
实验后删除:
[root@server1 cm]# kubectl delete -f pod1.yaml
pod "pod1" deleted
通过在pod的命令行下运行的方式
也可以使用Configmap设置命令行参数:
[root@server1 cm]# vim pod2.yaml
[root@server1 cm]# cat pod2.yaml
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: pod1
image: busybox
command: ["/bin/sh","-c","echo $(db_host) $(db_port)"]
envFrom:
- configMapRef:
name: cm4
restartPolicy: Never
上述文件表示直接再pod内调用输入的Configmap键值对
创建:
[root@server1 cm]# kubectl create -f pod2.yaml
pod/pod1 created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
pod1 0/1 Completed 0 5s
查看输出:
[root@server1 cm]# kubectl logs pod1
172.25.63.250 3306
表示成功输出
实验后删除:
[root@server1 cm]# kubectl delete -f pod2.yaml
pod "pod1" deleted
作为volume的方式挂载到pod内
通过数据卷使用Configmap:
[root@server1 cm]# vim pod3.yaml
[root@server1 cm]# cat pod3.yaml
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: pod1
image: busybox
command: ["/bin/sh","-c","cat /config/db_host"]
volumeMounts:
- name: config-volume
mountPath: /config
volumes:
- name: config-volume
configMap:
name: cm4
restartPolicy: Never
上述文件表示将cm4内的键值对挂载到容器内的/config下,这种方式创建时,键会成为文件名,值会成为文件内容:
[root@server1 cm]# kubectl create -f pod3.yaml
pod/pod1 created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
pod1 0/1 Completed 0 6s
查看输出:
[root@server1 cm]# kubectl logs pod1
172.25.63.250
实验后删除:
[root@server1 cm]# kubectl delete -f pod3.yaml
pod "pod1" deleted
也可以通过以下这种方式更加直观的理解:
[root@server1 cm]# vim pod3.yaml
[root@server1 cm]# cat pod3.yaml
apiVersion: v1
kind: Pod
metadata:
name: pod1
spec:
containers:
- name: pod1
image: myapp:v1
volumeMounts:
- name: config-volume
mountPath: /config
volumes:
- name: config-volume
configMap:
name: cm4
[root@server1 cm]# kubectl create -f pod3.yaml
pod/pod1 created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
pod1 1/1 Running 0 5s
[root@server1 cm]# kubectl exec -it pod1 -- sh
/ # cd /config/
/config # ls
db_host db_port #两个key所以由两个文件
/config # ls -l
total 0
lrwxrwxrwx 1 root root 14 Apr 28 16:46 db_host -> ..data/db_host
lrwxrwxrwx 1 root root 14 Apr 28 16:46 db_port -> ..data/db_port
/config # cat db_host #文件内容为value
172.25.63.250/config #
/config # cat db_port
3306/config #
/config #
可以看出所有的key都会成为文件,而文件内容为value。
实验后删除:
root@server1 cm]# kubectl delete -f pod3.yaml
pod "pod1" deleted
四、ConfigMap 热更新
把 ConfigMap 改成 v2,马上进容器看一眼,三处都还是 v1。这时如果直接删 Pod,会错过一个区别:原 Pod 的目录挂载能自己更新。这次用 kind 0.32.0 和 Kubernetes 1.35.5 做了个对照,等目录里的文件变了,再重建 Pod。
同一个键,三处读数
一个 Deployment 跑一个 BusyBox 容器,三处读的都是 settings 的 mode 键。环境变量用 configMapKeyRef 注入到 MODE。同一个卷挂两次,一次把整个目录挂到 /config,另一次用 subPath: mode 把单个文件挂到 /single-mode。每次采样都重新打开两个文件。
下面是原始日志中的四次读数。计时从 kubectl patch 成功返回开始,用单调时钟算耗时。每轮读完等一秒,再发下一次请求。
2026-11-18T15:09:50.936+00:00 elapsed=0.04s env=v1 dir=v1 subPath=v1
2026-11-18T15:10:53.561+00:00 elapsed=62.67s env=v1 dir=v1 subPath=v1
2026-11-18T15:10:54.663+00:00 elapsed=63.77s env=v1 dir=v2 subPath=v1
2026-11-18T15:10:55.930+00:00 replacement env=v2 dir=v2 subPath=v2
第 62.67 秒读完还是旧值,第 63.77 秒第一次读到目录新值。这两个数记录的是客户端收到读数的时刻,无法精确到节点切换文件的那一刻。其间 ConfigMap 的 UID 没变,resourceVersion 从 536 变成 557。
| 采样阶段 | Pod UID | 容器重启次数 |
|---|---|---|
| 修改前、目录首次读到 v2 后 | d583f2bb-c6dc-4d9b-8b30-8966b0d785bb | 0 |
执行 rollout restart 并等新 Pod 就绪后 | a21bfa1f-7b5b-4497-8fab-222a3d3679e9 | 0 |
在本地重跑
准备 Docker、kind 0.32.0、kubectl 1.35.5 和 Python 3,把下面两个文件放到同一个空目录。清单里的容器使用 imagePullPolicy: Never,所以要先把 BusyBox 载入节点。命令对应本次运行的 ARM64 环境。完整 YAML · 采样脚本 · 逐次采样原始日志
export KUBECONFIG="$PWD/kubeconfig"
cluster=cxykk-cm-xbverh
kind create cluster --name "$cluster" --kubeconfig "$KUBECONFIG" --wait 150s \
--image kindest/node:v1.35.5@sha256:ce977ae6d65918d0b58a5f8b5e940429c2ce42fa3a5619ec2bbc60b949c0ac95
image=busybox:1.37.0@sha256:a7dbc319b1438115a207e11930dc4bb3e643dcb3ec0bdd694bb36cd8fad289ec
docker pull --platform linux/arm64 "$image"
docker tag "$image" busybox:1.37.0
docker save --platform linux/arm64 -o busybox.tar busybox:1.37.0
kind load image-archive busybox.tar --name "$cluster"
kubectl apply -f configmap.yaml
kubectl -n cm-lab rollout status deployment/reader --timeout=120s
python3 observe.py && kind delete cluster --name "$cluster" --kubeconfig "$KUBECONFIG"
脚本先取 Pod 的名字和 UID,确认三个初始值,再执行下面这条 patch。读数始终取自同一个具名 Pod。等目录读到 v2 后才触发滚动重建。如果 180 秒还没读到,脚本会报超时,把现场留在重建之前。下面两行是脚本操作的对应命令,单独查看时把 POD 换成实际 Pod 名。
kubectl -n cm-lab patch cm settings --type merge -p '{"data":{"mode":"v2"}}'
kubectl -n cm-lab exec "$POD" -- sh -c 'printf "env=%s dir=%s subPath=%s\n" "$MODE" "$(cat /config/mode)" "$(cat /single-mode)"'
排查时先看挂载方式
这台节点的 kubelet 配置是 syncFrequency=1m0s、configMapAndSecretChangeDetectionStrategy=Watch。普通目录里的文件要等 kubelet 同步,耗时还受变更传播影响。查这类问题时,可以先核对 ConfigMap 的键和版本,再盯住同一 Pod 里的文件,多读几次。63.77 秒只是这次的首见时间。环境变量随容器启动注入,subPath 单文件挂载也收不到后续 ConfigMap 更新,这两种用法可以通过滚动替换 Pod 取到新值。Kubernetes 1.35 官方说明
如果文件已经是新值,服务却还在用旧配置,下一步该查应用何时重新打开文件、是否需要 reload。后面 Nginx 的例子替换了 Pod,它能验证新实例采用了新配置。要验证运行中的 Nginx 是否重新加载,需要另外观察原进程。环境变量与卷挂载的基础写法 · Nginx 单文件 subPath 挂载示例
原例:用 Deployment 替换 Pod
首先创建一个pod:
[root@server1 cm]# vim pod4.yaml
[root@server1 cm]# cat pod4.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-nginx
spec:
replicas: 1
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx
ports:
- containerPort: 80
volumeMounts:
- name: config-volume
mountPath: /config
volumes:
- name: config-volume
configMap:
name: cm4
上述文件表示使用Deployment控制器维护了一个副本的pod,且在容器内部使用了cm4中的键值对挂载了目录,先创建查看结果:
[root@server1 cm]# kubectl create -f pod4.yaml
deployment.apps/my-nginx created
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
my-nginx-7b55b857-bx6ff 1/1 Running 0 17s
[root@server1 cm]# kubectl exec -it my-nginx-7b55b857-bx6ff -- bash
root@my-nginx-7b55b857-bx6ff:/# cd config/
root@my-nginx-7b55b857-bx6ff:/config# ls
db_host db_port
root@my-nginx-7b55b857-bx6ff:/config# cat db_host
172.25.63.250root@my-nginx-7b55b857-bx6ff:/config#
root@my-nginx-7b55b857-bx6ff:/config# cat db_port
3306root@my-nginx-7b55b857-bx6ff:/config# exit
1
容器内的内容是从cm4中直接拿到的,我们现在来更新cm4的内容:
[root@server1 cm]# kubectl edit cm cm4
configmap/cm4 edited
如图,将db_host改为l了172.25.63.100,此时查看容器内部的情况:
[root@server1 cm]# kubectl exec -it my-nginx-7b55b857-bx6ff -- bash
root@my-nginx-7b55b857-bx6ff:/# cd config/
root@my-nginx-7b55b857-bx6ff:/config# cat db_host
172.25.63.250root@my-nginx-7b55b857-bx6ff:/config#
root@my-nginx-7b55b857-bx6ff:/config# exit
这一次 cat 仍然读到末尾为 250 的旧地址。原记录没有写下距修改过去了多久。接下来的两种操作都会替换 Pod,可以用来观察新 Pod 启动时读到的值。
第一种就时删除这个pod,那么Deployment控制器就会帮我们再新建一个pod,这样就实现了更新:
[root@server1 cm]# kubectl delete pod my-nginx-7b55b857-bx6ff
pod "my-nginx-7b55b857-bx6ff" deleted
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
my-nginx-7b55b857-q5kbk 1/1 Running 0 84s
此时查看容器内的内容:
可以看出已经更新。
还有一种方式是通过修改config/version来触发pod的滚动更新:
首先更改cm:
可以看出改成了200,此时还没有触发更新,修改config/version来触发pod的滚动更新:
[root@server1 cm]# kubectl patch deployments.apps my-nginx --patch '{"spec": {"template": {"metadata": {"annotations": {"version/config": "20200428"}}}}}'
deployment.apps/my-nginx patched
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
my-nginx-5b568c4dbf-gmtj7 1/1 Running 0 12s
查看容器内部的值:
可以看出db_host的值更新为200.
实验后删除:
[root@server1 cm]# kubectl delete -f pod4.yaml
deployment.apps "my-nginx" deleted
1
2
五、通过Configmap来部署nginx
编辑部署文件:
[root@server1 cm]# vim pod4.yaml
[root@server1 cm]# cat pod4.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-nginx
spec:
replicas: 1
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx
ports:
- containerPort: 80
volumeMounts:
- name: config-volume
mountPath: /etc/nginx/conf.d
volumes:
- name: config-volume
configMap:
name: nginxconf
上述文件表示将名为nginxconf(当然我们现在还没有,稍后我们会创建)的Configmap挂载到nginx配置目录/etc/nginx/conf.d中,以实现nginx的配置。
接下来我们创建名为nginxconf的Configmap:
[root@server1 cm]# vim nginx.conf
#注意:这个文件的名称不能变,因为nginx的配置文件名称就是这个名称
[root@server1 cm]# cat nginx.conf
server {
listen 8000; #监听端口8000
server_name _;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
#接下来以文件的形式创建configmap:
[root@server1 cm]# kubectl create configmap nginxconf --from-file=nginx.conf
configmap/nginxconf created
[root@server1 cm]# kubectl describe cm nginxconf #查看cm
Name: nginxconf
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
nginx.conf:
----
server {
listen 8000;
server_name _;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
Events: <none>
上述一系列的操作表示,cm挂接进入容器时key为文件名,键为文件内容,即将nginx.conf 文件挂接进入容器内的/etc/nginx/conf.d/nginx.conf ,这样就生成了nginx的配置文件。
接下来创建pod:
[root@server1 cm]# kubectl create -f pod4.yaml
deployment.apps/my-nginx created
[root@server1 cm]# kubectl get pod -o wide
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES
my-nginx-9f4f65995-nwlxr 1/1 Running 0 3s 10.244.1.71 server2 <none> <none>
访问pod:
配置成功,也可以进入容器内部直接查看nginx的配置文件:
[root@server1 cm]# kubectl exec -it my-nginx-9f4f65995-nwlxr -- bash
root@my-nginx-9f4f65995-nwlxr:/# cat /etc/nginx/conf.d/nginx.conf
server {
listen 8000;
server_name _;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
之后我们更改端口为8080:
[root@server1 cm]# kubectl edit cm nginxconf
configmap/nginxconf edited
[root@server1 cm]# kubectl describe cm nginxconf
Name: nginxconf
Namespace: default
Labels: <none>
Annotations: <none>
Data
====
nginx.conf:
----
server {
listen 8080; #更改成功
server_name _;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
}
}
Events: <none>
然后来触发更新:
[root@server1 cm]# kubectl patch deployments.apps my-nginx --patch '{"spec": {"template": {"metadata": {"annotations": {"version/config": "20200428"}}}}}'
deployment.apps/my-nginx patched
[root@server1 cm]# kubectl get pod
NAME READY STATUS RESTARTS AGE
my-nginx-5688cf6755-d8bw6 1/1 Running 0 8s
[root@server1 cm]# kubectl get pod -o wide
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES
my-nginx-5688cf6755-d8bw6 1/1 Running 0 16s 10.244.2.64 server3 <none> <none>
当然也可以使用删除pod的方法触发,接下来测试访问:
说明配置成功更新。
实验后删除:
[root@server1 cm]# kubectl delete -f pod4.yaml
deployment.apps "my-nginx" deleted