容器与云原生 / 系统课时
配置变更与应用重载
配置变更与应用重载
本课将通过可运行示例比较环境变量和挂载文件在 ConfigMap 变更后的表现,并据此选择文件监听、信号重载或滚动重启等可靠策略。
学习目标
- 解释环境变量与 ConfigMap 卷的更新差异。
- 验证配置变化是否已经进入容器并被应用读取。
- 根据应用能力选择热重载或滚动重启方案。
两条配置注入路径
环境变量在容器进程启动时写入,后续修改 ConfigMap 不会改变已运行进程的环境。ConfigMap 卷则由 kubelet 周期性刷新,文件内容可能在延迟后变化,但应用是否重新读取文件取决于自身实现。

这意味着“文件已经更新”和“应用已经使用新配置”是两个不同状态。生产验证必须同时检查配置载体、应用日志、健康状态和对外行为。
完整示例:观察两种更新行为
创建 reload-demo.yaml。容器每十秒同时打印环境变量和挂载文件中的值,便于直接比较。
apiVersion: v1
kind: ConfigMap
metadata:
name: reload-config
data:
APP_MODE: blue
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: reload-demo
spec:
replicas: 1
selector:
matchLabels:
app: reload-demo
template:
metadata:
labels:
app: reload-demo
spec:
containers:
- name: app
image: busybox:1.36
command:
- sh
- -c
- |
while true; do
printf '%s env=%s file=%s\n' "$(date +%H:%M:%S)" "$APP_MODE" "$(cat /config/APP_MODE)"
sleep 10
done
env:
- name: APP_MODE
valueFrom:
configMapKeyRef:
name: reload-config
key: APP_MODE
volumeMounts:
- name: config
mountPath: /config
readOnly: true
volumes:
- name: config
configMap:
name: reload-config应用清单并查看初始日志:
kubectl apply -f reload-demo.yaml
kubectl rollout status deployment/reload-demo
kubectl logs -l app=reload-demo --tail=2预期输出:
configmap/reload-config created
deployment.apps/reload-demo created
deployment "reload-demo" successfully rolled out
<TIME> env=blue file=blue
<TIME> env=blue file=blue<TIME> 是动态时间,实际值会不同。已有资源再次应用时,前两行也可能显示 configured 或 unchanged。
修改配置并验证传播
把 ConfigMap 改为 green,等待卷刷新后再次查看日志:
kubectl patch configmap reload-config --type merge -p '{"data":{"APP_MODE":"green"}}'
sleep 70
kubectl logs -l app=reload-demo --tail=4预期结果:
configmap/reload-config patched
<TIME> env=blue file=blue
<TIME> env=blue file=green日志行数和切换时刻可能不同,但关键现象是环境变量仍为 blue,挂载文件最终变为 green。若使用 subPath 挂载单个文件,文件通常也会继续保持旧值。
选择可靠的重载方式
应用原生支持文件监听时,应先读取新文件、完成语法与依赖校验,再原子切换到新配置;校验失败应保留旧配置并暴露明确错误。应用支持 SIGHUP 等重载信号时,可以由受控脚本或 Sidecar 在检测到文件变化后发送信号,但必须确认进程模型、权限和信号语义。
环境变量、subPath 文件或不支持热加载的程序,应通过重建 Pod 生效。最直接的手工验证方式是滚动重启 Deployment:
kubectl rollout restart deployment/reload-demo
kubectl rollout status deployment/reload-demo
kubectl logs deployment/reload-demo --tail=1预期输出:
deployment.apps/reload-demo restarted
deployment "reload-demo" successfully rolled out
<TIME> env=green file=green自动化发布时,通常把配置内容的摘要写入 Pod 模板注解。摘要变化会改变 PodTemplate,从而触发 Deployment 滚动更新;这种方式比依赖人工执行重启更可审计,也能复用现有的就绪检查和回滚机制。
验证与故障定位
重载后先确认 ConfigMap 当前值,再确认 Pod 创建时间、挂载文件内容和应用日志。若文件已更新但业务行为未变,问题通常在应用缓存或重载失败;若新 Pod 无法就绪,应查看配置解析错误,并让滚动更新停在旧副本仍可服务的状态。
配置更新不应只以 kubectl patch 成功作为完成标准。真正的验收是新配置被目标进程采用、Readiness 通过、关键请求返回符合预期,并且出现异常时可以恢复到上一份配置。