搜索结果: "configmap"

title: ConfigMap 挂载踩坑指南 — 符号链接 / 只读 / 热更新 / 标准挂载模式

tags: [kubernetes, troubleshooting, configmap, pod, storage, debugging]

sources: [raw/articles/configmap-mount-pitfalls.md]

# ConfigMap 挂载踩坑指南

> ConfigMap 里的"文件"，本质是**符号链接**，不是真文件。

title: Pod 排障 — CrashLoopBackOff / Exit Code 排查 / OOM / 探针 / 依赖服务 / ConfigMap

tags: [kubernetes, troubleshooting, pod, deployment, production, networking, configmap]

- raw/articles/configmap-mount-pitfalls.md

- **配置错误:** 检查 ConfigMap/Secret 挂载

6. 检查 ConfigMap/Secret/环境变量/挂载路径

tags: [kubernetes, deployment, architecture, build, networking, storage, monitoring, configmap, security, certificate, docker, container]

configMap:

### 4.2 使用 ConfigMap 管理 JCasC（Configuration as Code）

kind: ConfigMap

| JCasC 配置不生效 | Pod 启动后配置未加载 | `kubectl logs` 检查 CASC 插件日志；验证 ConfigMap YAML 缩进 |

### ConfigMap — 非敏感配置

kind: ConfigMap

1. 环境变量注入（`envFrom.configMapRef`）

2. 文件挂载（`volumes.configMap`）

**🔥 常见踩坑：** ConfigMap 以 Volume 挂载时创建符号链接，应用以 inotify 监听可能不触发；热更新有延迟。

| 8 | ConfigMap 热更新踩坑 | 应用级 | P2 中等 | subPath 只读 + 重启策略 |

### 案例 8：ConfigMap 热更新踩坑

**故障链：** 更新 ConfigMap 后应用没有加载新配置。

**根因：** ConfigMap 以 `subPath` 方式挂载 → 不会自动更新（subPath 是原子挂载）。

**修复：** 不挂载单个文件（不用 subPath），挂载整个目录 → ConfigMap 更新后会自动同步（约 60-90 秒），或配合 `kubectl rollout restart` 主动重启。

## [2026-05-11] ingest | 记一次 K8s ConfigMap 踩坑

- Created raw: raw/articles/configmap-mount-pitfalls.md

- Created concepts: configmap-mount-pitfalls

- 说明：10 大 K8s 生产故障案例（etcd/API Server/证书/节点/PDB/配额/HPA/ConfigMap/滚动更新/镜像），每个案例含故障链、根因、排查命令、止血、预防

| 7 | ConfigMap vs Secret？ | ConfigMap 存非敏感配置（明文），Secret 存敏感信息（Base64） | [[configmap-mount-pitfalls]] |

| 67 | 配置管理最佳实践？ | ConfigMap + Secret + Helm + External Secrets + GitOps |

| [[configmap-mount-pitfalls]] | ConfigMap 挂载踩坑 |

# - CreateContainerConfigError: 配置错误（ConfigMap/Secret）

kubectl get configmap -n kube-system kube-proxy -o yaml | grep mode

kubectl get configmap -n kube-system coredns -o yaml

云原生场景：K8S sysctl / 优雅停机 / Ingress-Nginx ConfigMap

### Ingress-Nginx ConfigMap

kind: ConfigMap

- [[configmap-mount-pitfalls]] — ConfigMap 挂载踩坑：符号链接只读/热更新/initContainer+emptyDir 标准模式

- [[k8s-production-incident-case-studies]] — K8s 生产 10 大故障复盘：etcd/API Server/证书/节点/PDB/配额/HPA/ConfigMap

- [[pod-troubleshooting]] — Pod 排障：CrashLoopBackOff / Exit Code / OOM / 探针 / 8 步排查法 / 依赖服务 / ConfigMap

- configmap: ConfigMap/Secret

| [[k8s-production-incident-case-studies]] | K8s 生产 10 大故障复盘（PDB/滚动更新/ConfigMap/HPA 等实战案例）

- [[k8s-production-incident-case-studies]] — K8s 生产 10 大故障复盘（etcd/证书/节点/PDB/配额/HPA/ConfigMap）

kubectl get configmap -n kube-system kube-proxy -o yaml | grep mode