容器与云原生 / 系统课时
配置更新与应用重载
配置更新与应用重载
修改 ConfigMap 并不意味着正在运行的进程会立刻得到新值。本节用同一个 Deployment 同时消费环境变量和挂载文件,实际观察两种更新路径,再据此选择应用热重载、Pod 滚动重建或版本化配置,避免“配置已改但业务仍用旧值”。
学习目标
- 能验证 ConfigMap 作为环境变量与作为卷文件时的更新行为差异。
- 能解释普通卷、
subPath与应用自身缓存对热更新结果的影响。 - 能为不支持热重载的应用设计滚动重启与可回滚的配置发布方案。
建立更新对照实验
先创建 app-config,再让 Deployment 同时通过环境变量 APP_MODE 和卷文件 /etc/app-config/APP_MODE 读取同一个键。这样只修改一次 ConfigMap,就能直接比较正在运行的进程和 kubelet 投射文件的行为。
kubectl apply -f - <<'EOF'
apiVersion: v1
kind: ConfigMap
metadata:
name: app-config
data:
APP_MODE: v1
EOF
kubectl apply -f - <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
name: config-demo
spec:
replicas: 1
selector:
matchLabels:
app: config-demo
template:
metadata:
labels:
app: config-demo
spec:
containers:
- name: app
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
env:
- name: APP_MODE
valueFrom:
configMapKeyRef:
name: app-config
key: APP_MODE
volumeMounts:
- name: config
mountPath: /etc/app-config
readOnly: true
volumes:
- name: config
configMap:
name: app-config
EOF
kubectl rollout status deployment/config-demo --timeout=90s首次执行的预期输出:
configmap/app-config created
deployment.apps/config-demo created
deployment "config-demo" successfully rolled out若资源已存在,apply 的状态可能是 configured 或 unchanged。
修改配置并观察两条更新路径
把 APP_MODE 从 v1 改为 v2。这里仍使用 kubectl create configmap --dry-run=client -o yaml | kubectl apply -f -,既避免手工编辑,也能重复执行。
kubectl create configmap app-config --from-literal=APP_MODE=v2 --dry-run=client -o yaml | kubectl apply -f -预期输出:
configmap/app-config configuredConfigMap 作为普通卷挂载时,kubelet 会跟踪变更并最终把新内容投射到 Pod;默认变更检测策略是 Watch,但传播不是同步事务,实际延迟取决于 kubelet 同步周期和缓存传播。相反,进程的环境变量在容器启动时确定,ConfigMap 后续变化不会原地修改该进程的环境。:contentReference[oaicite:6]{index=6}
等待卷文件完成更新后执行:
kubectl exec deployment/config-demo -- sh -c 'printf "env=%s file=%s\n" "$APP_MODE" "$(cat /etc/app-config/APP_MODE)"'预期输出:
env=v1 file=v2实际等待时间可能不同。如果把 ConfigMap 的某个键通过 subPath 挂成单个文件,则该挂载不会自动收到 ConfigMap 更新,因此不能把 subPath 当作热更新方案。:contentReference[oaicite:7]{index=7}
# 片段示例:依赖前面的 config 卷
volumeMounts:
- name: config
mountPath: /etc/myapp/app.conf
subPath: app.conf这段配置的生效行为是把单个键固定挂到指定路径;验证方法是更新 ConfigMap 后再次读取该路径,文件不会像普通目录挂载那样自动变成新版本。

让应用真正使用新配置
“文件变了”只代表 kubelet 已完成投射,不代表业务进程已经重新加载。若应用支持监听文件、定时重读或接收 SIGHUP,可以在文件更新后完成无重启热加载;若应用只在启动阶段读取配置,或者配置来自环境变量,就应重建 Pod。
对当前实验,最直接的做法是触发 Deployment 滚动重启:
kubectl rollout restart deployment/config-demo
kubectl rollout status deployment/config-demo --timeout=90s预期输出:
deployment.apps/config-demo restarted
deployment "config-demo" successfully rolled out新 Pod 启动后再次验证:
kubectl exec deployment/config-demo -- sh -c 'printf "env=%s file=%s\n" "$APP_MODE" "$(cat /etc/app-config/APP_MODE)"'预期输出:
env=v2 file=v2滚动重启会创建新 Pod,因此生产 Deployment 应配合就绪探针和合适的滚动更新参数,确保新副本真正可服务后再缩容旧副本。单纯更新 ConfigMap 不会自动触发 Deployment rollout。
把配置变更做成可回滚发布
不同消费方式应采用不同发布动作:
| 配置消费方式 | 更新后的 Kubernetes 行为 | 应用侧动作 |
|---|---|---|
| 环境变量 | 现有进程保持旧值 | 滚动重建 Pod |
| 普通 ConfigMap 卷 | 文件最终更新 | 应用重新读取或热重载 |
subPath 文件 |
不自动更新 | 避免用于热更新,或重建 Pod |
| 版本化 ConfigMap | Pod 只引用指定版本 | 修改 Pod 模板引用并滚动发布 |
需要稳定回滚时,不要只覆盖同名 ConfigMap。更稳妥的做法是生成 app-config-v42、app-config-v43 这类版本化对象,让 Deployment 的 Pod 模板显式引用某个版本;配置升级会自然触发模板变更和滚动发布,回滚时也能把引用切回上一版本。
判断方案时只问两个问题:运行中的进程能否重新读取配置,以及配置对象能否独立回到上一版本。前者决定热重载还是重建 Pod,后者决定是否需要版本化 ConfigMap;把这两个问题设计清楚,配置更新就能从一次手工修改变成可验证、可滚动、可回退的发布流程。