容器与云原生 / 系统课时

配置变更与应用重载

配置变更与应用重载

本课将通过可运行示例比较环境变量和挂载文件在 ConfigMap 变更后的表现,并据此选择文件监听、信号重载或滚动重启等可靠策略。

学习目标

  • 解释环境变量与 ConfigMap 卷的更新差异。
  • 验证配置变化是否已经进入容器并被应用读取。
  • 根据应用能力选择热重载或滚动重启方案。

两条配置注入路径

环境变量在容器进程启动时写入,后续修改 ConfigMap 不会改变已运行进程的环境。ConfigMap 卷则由 kubelet 周期性刷新,文件内容可能在延迟后变化,但应用是否重新读取文件取决于自身实现。

ConfigMap 变更后的注入与重载路径

这意味着“文件已经更新”和“应用已经使用新配置”是两个不同状态。生产验证必须同时检查配置载体、应用日志、健康状态和对外行为。

完整示例:观察两种更新行为

创建 reload-demo.yaml。容器每十秒同时打印环境变量和挂载文件中的值,便于直接比较。

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

应用清单并查看初始日志:

bash
kubectl apply -f reload-demo.yaml
kubectl rollout status deployment/reload-demo
kubectl logs -l app=reload-demo --tail=2

预期输出:

text
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,等待卷刷新后再次查看日志:

bash
kubectl patch configmap reload-config --type merge -p '{"data":{"APP_MODE":"green"}}'
sleep 70
kubectl logs -l app=reload-demo --tail=4

预期结果:

text
configmap/reload-config patched
<TIME> env=blue file=blue
<TIME> env=blue file=green

日志行数和切换时刻可能不同,但关键现象是环境变量仍为 blue,挂载文件最终变为 green。若使用 subPath 挂载单个文件,文件通常也会继续保持旧值。

选择可靠的重载方式

应用原生支持文件监听时,应先读取新文件、完成语法与依赖校验,再原子切换到新配置;校验失败应保留旧配置并暴露明确错误。应用支持 SIGHUP 等重载信号时,可以由受控脚本或 Sidecar 在检测到文件变化后发送信号,但必须确认进程模型、权限和信号语义。

环境变量、subPath 文件或不支持热加载的程序,应通过重建 Pod 生效。最直接的手工验证方式是滚动重启 Deployment:

bash
kubectl rollout restart deployment/reload-demo
kubectl rollout status deployment/reload-demo
kubectl logs deployment/reload-demo --tail=1

预期输出:

text
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 通过、关键请求返回符合预期,并且出现异常时可以恢复到上一份配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置变更与应用重载

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

登录哪都通