K8s配置管理实战|ConfigMap与Secret手把手实操,配置注入Pod全流程
引言
本篇适合已经掌握Pod、Volume存储基础的在校学生、运维入门新手。读完本篇博客你将学会:
- 搞懂ConfigMap配置字典:理解它的定位、使用限制;掌握4种创建方式:字面量、文件、目录、yaml;学会用环境变量、挂载卷两种方式把配置注入Pod;
- 搞懂Secret机密对象:和ConfigMap的区别;掌握Opaque通用密钥、docker‑registry镜像拉取凭证、TLS证书三种Secret类型;
- 掌握Secret两种注入Pod方式:环境变量、Volume卷挂载,了解base64编码特点;
- 综合实战案例:Haproxy负载均衡+Nginx WebPod,还有WordPress使用Secret保存数据库密码的完整思路。
基于K8s v1.30.2集群实操,全部yaml与命令可以直接复制复现,属于专栏云原生K8s系列第四篇。
前置说明
✅ 实操环境:已经部署完成的K8s v1.30.2三节点集群(master30、worker31、worker32),可正常执行kubectl命令。 ✅ 前置基础:熟悉Pod管理、Volume卷挂载,了解namespace命名空间,会编写基础yaml资源文件。 ✅ 上手难度:零基础可以跟着动手实操。
💡提示:代码块中
#后面为注释,不要复制执行;实验建议独立namespace做隔离,实验结束删除命名空间一键清理资源。
【待补图】这里应有一张图:ConfigMap/Secret注入Pod两种方式示意图
一、ConfigMap配置字典
比喻:ConfigMap就像集群里面的“配置文件工具箱”,把应用的配置、网页文本、参数单独抽离出来。配置和容器镜像解耦,改配置不需要重新构建镜像,直接修改ConfigMap即可。 ⚠️重要限制:ConfigMap只适合保存普通明文配置,不存放密码、密钥这类敏感数据;单对象最大1MiB,不适合存大量数据。
1.1 准备实验命名空间
# 创建独立实验命名空间
kubectl create ns configure
# 设置当前上下文默认ns,后续命令不用反复加-n参数
kubectl config set-context --current --namespace configure
1.2 ConfigMap四种创建方式
方式1:–from‑literal 字面量键值对
适合少量简单参数。
# 创建configmap,key是password,value是redhat
kubectl create configmap mysql-cm --from-literal=password=redhat
# 查看yaml输出
kubectl get configmaps mysql-cm -o yaml
方式2:–from‑file 从单个文件创建
把整个文件内容作为value,文件名作为key。
# 准备本地测试网页文件
echo "Hello World" > index.html
# 使用本地文件生成configmap
kubectl create configmap web-cm1 --from-file=./index.html
kubectl get configmaps web-cm1 -o yaml
方式3:–from‑directory 从整个目录创建
读取目录下全部文件,文件名作为key,文件内容作为value。
# 准备目录和两个网页
mkdir web-dir
echo "Hello World" > web-dir/index.html
echo "page error" > web-dir/error.html
# 读取整个目录生成configmap
kubectl create configmap web-cm2 --from-file=./web-dir
kubectl get configmaps web-cm2 -o yaml
方式4:直接编写yaml清单文件
# cm-demo.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: cm-demo
data:
username: "tom"
loglevel: "info"
index.html: |
<h1>demo page</h1>
kubectl apply -f cm-demo.yaml
kubectl get configmap cm-demo
1.3 ConfigMap注入Pod的两种方式
方式A:环境变量注入(容器级别)
适合少量配置参数;ConfigMap更新之后,已经运行的Pod环境变量不会自动刷新,需要重启Pod才生效。
pod‑cm‑env.yaml
apiVersion: v1
kind: Pod
metadata:
name: mysql-demo
spec:
containers:
- name: mysql
image: hub.user.cloud/library/mysql:latest
imagePullPolicy: IfNotPresent
ports:
- containerPort: 3306
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
configMapKeyRef:
name: mysql-cm
key: password
# 创建pod
kubectl apply -f pod-cm-env.yaml
# 进入容器打印环境变量,验证是否注入成功
kubectl exec -it mysql-demo -- bash -c 'echo $MYSQL_ROOT_PASSWORD'
# 删除pod
kubectl delete pod mysql-demo --force
方式B:Volume卷挂载注入(Pod级别)
将ConfigMap里面的key映射成容器内的文件;ConfigMap修改后,kubelet会周期性同步更新容器内的文件,不需要重启Pod。
案例1:挂载全部key
pod‑cm‑vol-all.yaml
apiVersion: v1
kind: Pod
metadata:
labels:
run: web
name: web-all
spec:
containers:
- name: nginx
image: hub.laoma.cloud/library/nginx:latest
imagePullPolicy: IfNotPresent
volumeMounts:
- name: web-content
mountPath: "/usr/share/nginx/html"
volumes:
- name: web-content
configMap:
name: web-cm2
kubectl apply -f pod-cm-vol-all.yaml
# 查看容器内生成的网页文件
kubectl exec web-all -- ls /usr/share/nginx/html
# 访问页面测试
kubectl get pod web-all -o wide
# curl 容器IP
案例2:只挂载指定key,使用items筛选
apiVersion: v1
kind: Pod
metadata:
labels:
run: web
name: web-single
spec:
containers:
- name: nginx
image: hub.laoma.cloud/library/nginx:latest
imagePullPolicy: IfNotPresent
volumeMounts:
- name: web-content
mountPath: "/usr/share/nginx/html"
volumes:
- name: web-content
configMap:
name: web-cm2
items:
- key: index.html
path: index.html
案例3:subPath,只挂载单个文件,不覆盖整个目录
subPath:只把单个key映射为单个文件,不会覆盖挂载目录里面原有其他文件。
volumeMounts:
- name: web-content
mountPath: "/usr/share/nginx/html/index.html"
subPath: index.html
⚠️注意:subPath挂载的文件,ConfigMap更新不会自动同步。
1.4 综合小案例:Haproxy + Nginx多WebPod
需求简述:
- webapp‑1、webapp‑2两个Nginx Pod,ConfigMap提供网页index.html;
- haproxy Pod读取ConfigMap里面的haproxy.cfg负载均衡配置,转发流量到两个web。
核心要点:haproxy配置文件通过configmap卷挂载;web网页内容同样使用configmap注入。
二、Secret机密配置对象
比喻:Secret和ConfigMap功能大体类似,专门用来存放密码、数据库密钥、TLS证书、镜像仓库凭证这类敏感信息。 注意:Secret只是做base64编码,不是加密!base64可以直接反向解码,不能当作强加密使用。
2.1 Secret三种类型
- Opaque(generic通用):默认类型,保存普通密码、字符串。
- kubernetes.io/dockerconfigjson:镜像仓库登录凭证,拉取私有镜像使用。
- kubernetes.io/tls:存放TLS证书和私钥,用于HTTPS。
2.2 Opaque通用Secret创建
① --from‑literal字面量
kubectl create secret generic db-secret \
--from-literal=root-password=Redhat@123 \
--from-literal=user=tom
kubectl get secrets db-secret -o yaml
yaml中data字段内容全部为base64编码,可直接解码查看明文。
② --from‑file 从文件创建
echo "Redhat@456" > pass.txt
kubectl create secret generic file-secret --from-file=./pass.txt
③ --from‑env‑file 从env格式文本创建
cat > env.txt <<'EOF'
username=admin
password=Admin@789
EOF
kubectl create secret generic env-secret --from-env-file=./env.txt
④ yaml清单方式编写secret
apiVersion: v1
kind: Secret
metadata:
name: yaml-secret
type: Opaque
data:
# 值必须base64编码之后填写
username: YWRtaW4=
password: UmVkaGF0QDEyMw==
2.3 docker‑registry 镜像拉取凭证Secret
私有镜像仓库拉取镜像时,Pod通过这个Secret提供登录账号密码。
kubectl create secret docker-registry reg-secret \
--docker-username=user01 \
--docker-password=Pass@123 \
--docker-email=user@demo.com \
--docker-server=registry.user.cloud
2.4 TLS证书Secret(HTTPS)
存放PEM格式证书与私钥,Ingress HTTPS场景大量使用。
# openssl生成测试证书私钥
openssl genrsa -out www.key 2048
openssl req -new -key www.key -out www.csr -subj "/C=CN/ST=JS/L=NJ/O=DEMO/CN=demo.user.cloud"
openssl x509 -req -days 3650 -in www.csr -signkey www.key -out www.crt
# 创建tls类型secret
kubectl create secret tls www-tls --cert=./www.crt --key=./www.key
2.5 Secret注入Pod两种方式
方式A:环境变量注入
pod‑secret‑env.yaml
apiVersion: v1
kind: Pod
metadata:
name: mysql‑sec
spec:
containers:
- name: mysql
image: hub.user.cloud/library/mysql:latest
imagePullPolicy: IfNotPresent
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: db-secret
key: root-password
kubectl apply -f pod-secret-env.yaml
kubectl exec -it mysql‑sec -- bash -c 'echo $MYSQL_ROOT_PASSWORD'
kubectl delete pod mysql‑sec --force
方式B:Volume卷挂载注入
Secret的key映射成容器内文件,文件权限可以通过defaultMode控制。 pod‑secret‑vol.yaml
apiVersion: v1
kind: Pod
metadata:
labels:
run: web‑sec
name: web‑sec
spec:
containers:
- name: nginx
image: hub.user.cloud/library/nginx:latest
imagePullPolicy: IfNotPresent
volumeMounts:
- name: sec‑vol
mountPath: "/opt/secret/"
volumes:
- name: sec‑vol
secret:
secretName: db-secret
defaultMode: 256 # 对应八进制400权限
kubectl apply -f pod-secret-vol.yaml
kubectl exec web‑sec -- ls -l /opt/secret
kubectl delete pod web‑sec --force
注意:和ConfigMap卷行为一致:普通volume挂载secret,secret更新,容器内文件会被kubelet周期性同步;如果使用subPath挂载则不会自动更新。
2.6 综合业务思路:WordPress使用Secret
业务需求:部署wordpress,数据库账号密码存放在Secret,不要写死在Pod yaml。
- 创建Secret保存mysql root密码、普通账号密码;
- mysql Pod使用
secretKeyRef环境变量读取密码; - wordpress Pod同样通过环境变量读取数据库账号密码,连接mysql。
🚨新手常见坑
-
❌修改ConfigMap之后,Pod环境变量没有拿到新配置
✅原因:环境变量注入方式,Pod启动时一次性读取ConfigMap。解决:删除重建Pod,环境变量才会刷新;卷挂载不使用subPath可以自动同步。
-
❌ConfigMap使用subPath挂载单个文件,修改cm,容器内文件不变
✅subPath模式不支持自动热更新,必须重启Pod。
-
❌Secret当成加密,直接存放核心业务密码
✅Secret仅base64编码,可以随意解码;不要把Secret等同于加密,集群内有权限的用户可以读取解码内容。
-
❌创建secret传入明文,yaml查看变成乱码
✅属于base64正常编码;
echo -n "编码字符串" | base64 -d即可解码得到明文。 -
❌ConfigMap存放几百MB大文件,创建报错
✅ConfigMap对象上限1MiB,大文件不要放cm,改用PV/PVC存储卷。
-
❌docker‑registry类型secret创建失败,拉私有镜像报错ImagePullBackOff
✅检查镜像仓库地址、账号密码;pod的spec.imagePullSecrets引用该secret。
-
❌TLS类型secret,证书crt、key搞反,ingress HTTPS启动异常
✅创建tls secret:
--cert传公钥crt,--key传私钥key,参数不要颠倒。 -
❌ConfigMap/Secret卷挂载,目录下原有文件全部消失
✅整个卷挂载会完全覆盖容器内目标目录;只想替换单个文件,使用items筛选key或者subPath。
总结
- ConfigMap:存放普通明文配置,支持字面量、文件、目录、yaml四种创建;注入Pod分为环境变量、Volume卷挂载;环境变量不会热更新;卷挂载不使用subPath可自动同步;上限1MiB,不存敏感密码。
- Secret:专门保存敏感信息,只有base64编码,非加密;三种类型Opaque通用、docker‑registry镜像凭证、tls证书;同样支持环境变量、卷挂载注入Pod。
- 挂载细节:subPath只挂载单个文件,关闭热更新;volume卷挂载支持defaultMode设置文件权限。
- 业务最佳实践:应用配置放ConfigMap;密码、证书、仓库凭证放Secret;配置与镜像解耦,修改配置不用重新构建镜像。
思考题&互动
- ConfigMap以环境变量注入Pod,修改ConfigMap,正在运行的Pod能不能自动读到新配置?为什么?
- Secret是加密保存数据吗?base64编码有什么特点?
- subPath挂载ConfigMap/Secret,热更新是否生效?
- docker‑registry类型的Secret一般用来解决什么业务场景?
欢迎评论区分享你的实操踩坑,建议完整复现ConfigMap、Secret各类创建与Pod注入加深理解!
👉本文章属于专栏:《Linux 运维从小白到实战|全套 CentOS7 云计算实战专栏》,专栏持续更新Linux、Shell、虚拟化、私有云、公有云全套实操笔记,欢迎订阅一起学习。