K8s配置管理实战|ConfigMap与Secret手把手实操,配置注入Pod全流程

Source

K8s配置管理实战|ConfigMap与Secret手把手实操,配置注入Pod全流程

引言

本篇适合已经掌握Pod、Volume存储基础的在校学生、运维入门新手。读完本篇博客你将学会:

  1. 搞懂ConfigMap配置字典:理解它的定位、使用限制;掌握4种创建方式:字面量、文件、目录、yaml;学会用环境变量、挂载卷两种方式把配置注入Pod;
  2. 搞懂Secret机密对象:和ConfigMap的区别;掌握Opaque通用密钥、docker‑registry镜像拉取凭证、TLS证书三种Secret类型;
  3. 掌握Secret两种注入Pod方式:环境变量、Volume卷挂载,了解base64编码特点;
  4. 综合实战案例: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

需求简述:

  1. webapp‑1、webapp‑2两个Nginx Pod,ConfigMap提供网页index.html;
  2. haproxy Pod读取ConfigMap里面的haproxy.cfg负载均衡配置,转发流量到两个web。

核心要点:haproxy配置文件通过configmap卷挂载;web网页内容同样使用configmap注入。


二、Secret机密配置对象

比喻:Secret和ConfigMap功能大体类似,专门用来存放密码、数据库密钥、TLS证书、镜像仓库凭证这类敏感信息。 注意:Secret只是做base64编码,不是加密!base64可以直接反向解码,不能当作强加密使用。

2.1 Secret三种类型

  1. Opaque(generic通用):默认类型,保存普通密码、字符串。
  2. kubernetes.io/dockerconfigjson:镜像仓库登录凭证,拉取私有镜像使用。
  3. 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。

  1. 创建Secret保存mysql root密码、普通账号密码;
  2. mysql Pod使用secretKeyRef环境变量读取密码;
  3. wordpress Pod同样通过环境变量读取数据库账号密码,连接mysql。

🚨新手常见坑

  1. ❌修改ConfigMap之后,Pod环境变量没有拿到新配置

    ✅原因:环境变量注入方式,Pod启动时一次性读取ConfigMap。解决:删除重建Pod,环境变量才会刷新;卷挂载不使用subPath可以自动同步。

  2. ❌ConfigMap使用subPath挂载单个文件,修改cm,容器内文件不变

    ✅subPath模式不支持自动热更新,必须重启Pod。

  3. ❌Secret当成加密,直接存放核心业务密码

    ✅Secret仅base64编码,可以随意解码;不要把Secret等同于加密,集群内有权限的用户可以读取解码内容。

  4. ❌创建secret传入明文,yaml查看变成乱码

    ✅属于base64正常编码;echo -n "编码字符串" | base64 -d即可解码得到明文。

  5. ❌ConfigMap存放几百MB大文件,创建报错

    ✅ConfigMap对象上限1MiB,大文件不要放cm,改用PV/PVC存储卷。

  6. ❌docker‑registry类型secret创建失败,拉私有镜像报错ImagePullBackOff

    ✅检查镜像仓库地址、账号密码;pod的spec.imagePullSecrets引用该secret。

  7. ❌TLS类型secret,证书crt、key搞反,ingress HTTPS启动异常

    ✅创建tls secret:--cert传公钥crt,--key传私钥key,参数不要颠倒。

  8. ❌ConfigMap/Secret卷挂载,目录下原有文件全部消失

    ✅整个卷挂载会完全覆盖容器内目标目录;只想替换单个文件,使用items筛选key或者subPath。

总结

  1. ConfigMap:存放普通明文配置,支持字面量、文件、目录、yaml四种创建;注入Pod分为环境变量、Volume卷挂载;环境变量不会热更新;卷挂载不使用subPath可自动同步;上限1MiB,不存敏感密码。
  2. Secret:专门保存敏感信息,只有base64编码,非加密;三种类型Opaque通用、docker‑registry镜像凭证、tls证书;同样支持环境变量、卷挂载注入Pod。
  3. 挂载细节:subPath只挂载单个文件,关闭热更新;volume卷挂载支持defaultMode设置文件权限。
  4. 业务最佳实践:应用配置放ConfigMap;密码、证书、仓库凭证放Secret;配置与镜像解耦,修改配置不用重新构建镜像。

思考题&互动

  1. ConfigMap以环境变量注入Pod,修改ConfigMap,正在运行的Pod能不能自动读到新配置?为什么?
  2. Secret是加密保存数据吗?base64编码有什么特点?
  3. subPath挂载ConfigMap/Secret,热更新是否生效?
  4. docker‑registry类型的Secret一般用来解决什么业务场景?

欢迎评论区分享你的实操踩坑,建议完整复现ConfigMap、Secret各类创建与Pod注入加深理解!

👉本文章属于专栏:《Linux 运维从小白到实战|全套 CentOS7 云计算实战专栏》,专栏持续更新Linux、Shell、虚拟化、私有云、公有云全套实操笔记,欢迎订阅一起学习。