容器与云原生 / 系统课时
配置文件挂载
配置文件挂载
本课将把 ConfigMap 中的键值投射为容器内文件,完成目录挂载、键名到文件名映射和单文件 subPath 挂载,并通过实际更新验证两种方式的行为差异。
学习目标
- 使用 ConfigMap 卷把多个配置项挂载为容器内文件。
- 使用
items控制键名、文件名和文件权限。 - 判断何时可以使用
subPath,并规避配置无法自动更新的问题。
从配置对象到容器文件
ConfigMap 以键值形式保存非敏感配置。作为卷挂载时,每个键会投射为一个文件,键名默认成为文件名,值成为文件内容。容器读取的是普通文件,因此应用无需调用 Kubernetes API。

目录挂载会占用目标目录,因此该目录在镜像中的原有文件会被挂载内容遮蔽。需要保留原目录其他文件时,可以改挂载到专用目录,或使用 subPath 精确挂载单个文件。
完整示例:同时挂载目录和单文件
创建 config-file-demo.yaml。items 显式声明要投射的键,并把默认权限设为只读文件常用的 0444。
apiVersion: v1
kind: ConfigMap
metadata:
name: file-config
data:
app.yaml: |
server:
port: 8080
log.properties: |
level=info
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: config-file-demo
spec:
replicas: 1
selector:
matchLabels:
app: config-file-demo
template:
metadata:
labels:
app: config-file-demo
spec:
containers:
- name: app
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
volumeMounts:
- name: config
mountPath: /etc/demo
readOnly: true
- name: config
mountPath: /etc/app.yaml
subPath: app.yaml
readOnly: true
volumes:
- name: config
configMap:
name: file-config
defaultMode: 0444
items:
- key: app.yaml
path: app.yaml
- key: log.properties
path: log.properties该配置会生成 /etc/demo/app.yaml、/etc/demo/log.properties,并把同一个 app.yaml 单独挂载到 /etc/app.yaml。subPath 的父目录必须在镜像中可用,本例选择已有的 /etc。
应用清单并读取两个位置:
kubectl apply -f config-file-demo.yaml
kubectl rollout status deployment/config-file-demo
POD=$(kubectl get pod -l app=config-file-demo -o jsonpath='{.items[0].metadata.name}')
kubectl exec "$POD" -- sh -c 'printf "[directory]\n"; cat /etc/demo/app.yaml; printf "[subPath]\n"; cat /etc/app.yaml'预期输出:
configmap/file-config created
deployment.apps/config-file-demo created
deployment "config-file-demo" successfully rolled out
[directory]
server:
port: 8080
[subPath]
server:
port: 8080在非空环境中,created 可能显示为 configured 或 unchanged,但两个文件内容应一致。
验证更新差异
修改 ConfigMap 后,目录挂载通常会在 kubelet 的同步与缓存周期后更新,不保证立即生效;通过 subPath 挂载的文件不会自动接收这类更新。
kubectl patch configmap file-config --type merge -p '{"data":{"app.yaml":"server:\n port: 9090\n"}}'
sleep 70
POD=$(kubectl get pod -l app=config-file-demo -o jsonpath='{.items[0].metadata.name}')
kubectl exec "$POD" -- sh -c 'printf "[directory]\n"; cat /etc/demo/app.yaml; printf "[subPath]\n"; cat /etc/app.yaml'预期输出:
configmap/file-config patched
[directory]
server:
port: 9090
[subPath]
server:
port: 8080实际同步时间可能不同。若目录文件仍未变化,应继续等待并确认 Pod 使用的确实是当前 ConfigMap;不要把固定的等待秒数当作生产环境重载协议。
选择与排错要点
需要整组配置并希望后续更新可见时,优先挂载目录。只有应用必须在固定路径读取单个文件,而且配置变化可以通过重建 Pod 生效时,才使用 subPath。
出现 CreateContainerConfigError 时,先检查 ConfigMap 名称和 items.key 是否存在。文件路径不符合预期时,再检查 items.path、挂载目录和 subPath 是否完全一致。配置文件存在但应用仍读取旧值时,要确认应用是否缓存了配置,而不是只检查文件内容。