容器与云原生 / 系统课时

配置更新与应用重载

配置更新与应用重载

修改 ConfigMap 并不意味着正在运行的进程会立刻得到新值。本节用同一个 Deployment 同时消费环境变量和挂载文件,实际观察两种更新路径,再据此选择应用热重载、Pod 滚动重建或版本化配置,避免“配置已改但业务仍用旧值”。

学习目标

  • 能验证 ConfigMap 作为环境变量与作为卷文件时的更新行为差异。
  • 能解释普通卷、subPath 与应用自身缓存对热更新结果的影响。
  • 能为不支持热重载的应用设计滚动重启与可回滚的配置发布方案。

建立更新对照实验

先创建 app-config,再让 Deployment 同时通过环境变量 APP_MODE 和卷文件 /etc/app-config/APP_MODE 读取同一个键。这样只修改一次 ConfigMap,就能直接比较正在运行的进程和 kubelet 投射文件的行为。

bash
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

首次执行的预期输出:

text
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 -,既避免手工编辑,也能重复执行。

bash
kubectl create configmap app-config   --from-literal=APP_MODE=v2   --dry-run=client -o yaml | kubectl apply -f -

预期输出:

text
configmap/app-config configured

ConfigMap 作为普通卷挂载时,kubelet 会跟踪变更并最终把新内容投射到 Pod;默认变更检测策略是 Watch,但传播不是同步事务,实际延迟取决于 kubelet 同步周期和缓存传播。相反,进程的环境变量在容器启动时确定,ConfigMap 后续变化不会原地修改该进程的环境。:contentReference[oaicite:6]{index=6}

等待卷文件完成更新后执行:

bash
kubectl exec deployment/config-demo -- sh -c   'printf "env=%s file=%s\n" "$APP_MODE" "$(cat /etc/app-config/APP_MODE)"'

预期输出:

text
env=v1 file=v2

实际等待时间可能不同。如果把 ConfigMap 的某个键通过 subPath 挂成单个文件,则该挂载不会自动收到 ConfigMap 更新,因此不能把 subPath 当作热更新方案。:contentReference[oaicite:7]{index=7}

yaml
# 片段示例:依赖前面的 config 卷
volumeMounts:
  - name: config
    mountPath: /etc/myapp/app.conf
    subPath: app.conf

这段配置的生效行为是把单个键固定挂到指定路径;验证方法是更新 ConfigMap 后再次读取该路径,文件不会像普通目录挂载那样自动变成新版本。

ConfigMap 更新后的文件热更新与环境变量滚动重建路径

让应用真正使用新配置

“文件变了”只代表 kubelet 已完成投射,不代表业务进程已经重新加载。若应用支持监听文件、定时重读或接收 SIGHUP,可以在文件更新后完成无重启热加载;若应用只在启动阶段读取配置,或者配置来自环境变量,就应重建 Pod。

对当前实验,最直接的做法是触发 Deployment 滚动重启:

bash
kubectl rollout restart deployment/config-demo
kubectl rollout status deployment/config-demo --timeout=90s

预期输出:

text
deployment.apps/config-demo restarted
deployment "config-demo" successfully rolled out

新 Pod 启动后再次验证:

bash
kubectl exec deployment/config-demo -- sh -c   'printf "env=%s file=%s\n" "$APP_MODE" "$(cat /etc/app-config/APP_MODE)"'

预期输出:

text
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;把这两个问题设计清楚,配置更新就能从一次手工修改变成可验证、可滚动、可回退的发布流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置更新与应用重载

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通