ConfigMap挂载需确保key名与目标文件名一致、mountPath为目录（整挂载）或配合subPath指定文件路径（单文件挂载），且容器内路径可写。
在 Kubernetes 中将 ConfigMap 挂载为配置文件到容器内指定路径，是解耦配置与镜像的核心操作，必须确保挂载路径是目录、键名与目标文件名匹配、且容器内路径可写。
准备 ConfigMap 数据源
先创建一个含真实配置内容的 ConfigMap。推荐使用 --from-file=KEY=PATH 显式指定键名，避免默认用文件名作 key 导致路径不一致问题：
kubectl create configmap nginx-conf --from-file=nginx.conf=./nginx.conf
这一步关键在于 【KEY 必须与你后续想挂载出的文件名完全一致】，比如你要让容器里出现 /etc/nginx/nginx.conf，那 ConfigMap 里的 key 就得叫 nginx.conf，不能是 my-nginx.conf 或 ./nginx.conf。
编写 Pod YAML 并声明 Volume 挂载
在 Pod spec 中定义 volume 和 volumeMounts，注意三点：volume 名称要和 volumeMounts.name 对应；mountPath 必须是目录；subPath 可选但仅用于单文件挂载。
方法一：挂载整个 ConfigMap 到目录（自动展开所有 key 为文件）
在 volumes 下写：
- name: nginx-config configMap: name: nginx-conf
在 volumeMounts 下写：
- name: nginx-config mountPath: /etc/nginx
此时 ConfigMap 中的 nginx.conf 键会以文件形式出现在 /etc/nginx/nginx.conf。但注意：【mountPath 必须是目录，不能写成 /etc/nginx/nginx.conf】，否则挂载失败。
方法二：只挂载单个 key 到指定文件路径（用 subPath）
适用于不想污染整个目录、或需覆盖容器原有文件的场景：
- name: nginx-config configMap: name: nginx-conf items: - key: nginx.conf path: nginx.conf
对应 volumeMounts 写：
- name: nginx-config mountPath: /etc/nginx/nginx.conf subPath: nginx.conf
这步能精准控制文件落点，但必须同时设置 subPath 和 mountPath 指向具体文件路径——这是唯一允许 mountPath 为文件的合法方式。
部署并验证挂载结果
执行 kubectl apply -f pod.yaml 创建 Pod。
等 Pod 进入 Running 状态后，用 exec 进入容器检查：
kubectl exec -it <pod-name> -- ls -l /etc/nginx/</pod-name>
看到 nginx.conf 文件存在，且内容与 ConfigMap 中一致，说明挂载成功。
如果文件缺失，优先检查 ConfigMap 的 key 名是否拼写错误、Pod 是否在正确命名空间、以及 mountPath 是否误用了文件路径而非目录。
