ConfigMap 改了没生效:subPath 与 env 是两处静默陷阱
线上的配置改动没生效,最常见的追问是「是不是 kubelet 没同步」。多数时候不是。ConfigMap 怎么被 Pod 消费,决定了它能不能热更新;这一步没分清,后面查多久都是白费。 一、先分清四种消费方式 同一个 ConfigMap,进 Pod 的路径只有几条:作为环境变量注入、作为命令行参数、以卷的方式挂载成文件,或者由应用直接调用 API 读取。前三种是 kubelet 在启动容器时喂给进程的,最后一种由应用自己订阅变更。差别就在这里。 二、环境变量:启动时的快照,不会自己变 用 envFrom 或 valueFrom 注入的配置,在容器启动那一刻就固定了。之后改 ConfigMap,容器里的环境变量不会跟着变——官方文档写得很明确,以环境变量方式消费的 ConfigMap 不会自动更新,需要重建 Pod 才能生效。所以这类配置要配合工作负载的滚动更新,而不是等它自己刷新。 三、普通卷挂载:会同步,但不是「立刻」 把 ConfigMap 挂成目录(volumeMounts 指到某个目录,不带 subPath),kubelet 会周期性同步挂载内容。默认同步周期在 1 分钟量级,实际生效时间还要叠加 kubelet 的缓存 TTL,所以看到「改了要等一会儿才变」是正常的,不是故障。这里还有两个隐含条件:一是应用要重新读文件,不能只在启动时读一次放进内存;二是更新是原子替换符号链接,正在读旧文件句柄的进程仍会读到旧内容。文件监听类方案要能处理这种替换,别只盯着 inode。 四、subPath:最隐蔽的坑,永远不会热更新 如果挂载时写了 subPath,比如只把 ConfigMap 里的一个 key 挂成单个文件,那么 kubelet 的卷同步不会更新它。原因是 subPath 在容器启动时就解析并绑定到了具体路径,后续的卷同步覆盖不到。这个行为在官方文档里写得很直接:以 subPath 方式挂载 ConfigMap 的容器不会收到 ConfigMap 更新。我见过最多的「配置热更新失效」,根因就是这一行 subPath。 要热更新就别用 subPath:把整个目录挂进来,应用按文件名读;确实只需要一个文件的,也可以挂目录后用相对路径指向它。如果业务上必须保留单文件挂载,那就接受「改配置要重建 Pod」这个前提,用注解校验和触发滚动更新。 五、immutable:不是不生效,是根本不让改 把 ConfigMap 标成 immutable 之后,它就不能再修改,只能删掉重建。这个特性适合那些「上线后不该变」的配置,能减少 kubelet 的 watch 压力;但它和热更新是互斥的。排查时如果发现改不动,先看有没有 immutable: true,别在同步机制上绕圈。 六、一套排查顺序 一、确认 Pod 是怎么消费这个 ConfigMap 的:env、普通卷,还是 subPath。二、如果是 subPath,直接判定不会热更新,改挂载方式或接受重启。三、如果是 env,确认是否需要重建 Pod,并检查 Deployment 模板有没有变化。四、如果是普通卷,看应用是否每次请求都重新读文件,排除应用层缓存。五、再考虑 kubelet 同步周期和延迟。六、最后看 immutable。 七、三个高频误配 第一个,用 subPath 挂单个配置文件,却按「热更新」设计,改完以为会生效。第二个,用环境变量注入,却没配滚动更新触发条件,改完 ConfigMap 什么都不发生。第三个,以为改 ConfigMap 会自动触发 Deployment 滚动——不会,Deployment 的 Pod 模板没变,控制器就没有理由重建 Pod。想让配置变更驱动重建,通常是在模板里放一个校验和注解,配置变了注解就变,滚动才被触发。 八、我的取舍 需要热更新的配置,我用目录挂载,应用侧监听文件变化并做原子重载;需要「所有副本看到同一份值」的配置,我用环境变量加校验和注解,变更时整批滚动。两种都成立,前提是先想清楚这份配置到底要不要热更新。把 subPath 当热更新用,是最容易在上线后才暴露的那种错。 参考: https://kubernetes.io/docs/concepts/configuration/configmap/
- 点赞
- 收藏
- 关注作者
评论(0)