首页/云/Kubernetes 速查/ConfigMap 以卷方式挂载
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条
配置与存储54 条
调度与资源52 条集群运维与排障54 条

ConfigMap 以卷方式挂载

把 ConfigMap 的键做成文件挂到容器目录,支持 items 挑选与重命名键、指定路径;适合配置文件类数据。

Kubernetes 速查云更新于 2026-10-12

卷挂载示例

卷挂载示例
spec:
  containers:
    - name: app
      image: registry.example.com/app:1.26.0
      volumeMounts:
        - name: config
          mountPath: /etc/app/conf.d
          readOnly: true
  volumes:
    - name: config
      configMap:
        name: app-config
        items:
          - key: app.properties
            path: app.properties
          - key: LOG_LEVEL
            path: log-level.txt

验证

验证
kubectl exec -it web-x -- ls -l /etc/app/conf.d
kubectl exec -it web-x -- cat /etc/app/conf.d/log-level.txt
卷里的文件会随 ConfigMap 更新自动同步(分钟级),这是与 env 注入的关键区别。

易错点

  • mountPath 是目录时该目录原有内容会被覆盖,挂到既有配置目录前先确认镜像内容
  • 用 subPath 挂单文件不会自动更新,改配置需重建 Pod(见 subPath 条目)

数据来源与参考

  • Kubernetes 官方文档 · ConfigMap(Volume 挂载)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌