容器与云原生 / 系统课时

配置文件挂载

配置文件挂载

本课将把 ConfigMap 中的键值投射为容器内文件,完成目录挂载、键名到文件名映射和单文件 subPath 挂载,并通过实际更新验证两种方式的行为差异。

学习目标

  • 使用 ConfigMap 卷把多个配置项挂载为容器内文件。
  • 使用 items 控制键名、文件名和文件权限。
  • 判断何时可以使用 subPath,并规避配置无法自动更新的问题。

从配置对象到容器文件

ConfigMap 以键值形式保存非敏感配置。作为卷挂载时,每个键会投射为一个文件,键名默认成为文件名,值成为文件内容。容器读取的是普通文件,因此应用无需调用 Kubernetes API。

ConfigMap 目录挂载与 subPath 单文件挂载关系

目录挂载会占用目标目录,因此该目录在镜像中的原有文件会被挂载内容遮蔽。需要保留原目录其他文件时,可以改挂载到专用目录,或使用 subPath 精确挂载单个文件。

完整示例:同时挂载目录和单文件

创建 config-file-demo.yaml。items 显式声明要投射的键,并把默认权限设为只读文件常用的 0444。

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: file-config
data:
  app.yaml: |
    server:
      port: 8080
  log.properties: |
    level=info
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: config-file-demo
spec:
  replicas: 1
  selector:
    matchLabels:
      app: config-file-demo
  template:
    metadata:
      labels:
        app: config-file-demo
    spec:
      containers:
        - name: app
          image: busybox:1.36
          command: ["sh", "-c", "sleep 3600"]
          volumeMounts:
            - name: config
              mountPath: /etc/demo
              readOnly: true
            - name: config
              mountPath: /etc/app.yaml
              subPath: app.yaml
              readOnly: true
      volumes:
        - name: config
          configMap:
            name: file-config
            defaultMode: 0444
            items:
              - key: app.yaml
                path: app.yaml
              - key: log.properties
                path: log.properties

该配置会生成 /etc/demo/app.yaml、/etc/demo/log.properties,并把同一个 app.yaml 单独挂载到 /etc/app.yaml。subPath 的父目录必须在镜像中可用,本例选择已有的 /etc。

应用清单并读取两个位置:

bash
kubectl apply -f config-file-demo.yaml
kubectl rollout status deployment/config-file-demo
POD=$(kubectl get pod -l app=config-file-demo -o jsonpath='{.items[0].metadata.name}')
kubectl exec "$POD" -- sh -c 'printf "[directory]\n"; cat /etc/demo/app.yaml; printf "[subPath]\n"; cat /etc/app.yaml'

预期输出:

text
configmap/file-config created
deployment.apps/config-file-demo created
deployment "config-file-demo" successfully rolled out
[directory]
server:
  port: 8080
[subPath]
server:
  port: 8080

在非空环境中,created 可能显示为 configured 或 unchanged,但两个文件内容应一致。

验证更新差异

修改 ConfigMap 后,目录挂载通常会在 kubelet 的同步与缓存周期后更新,不保证立即生效;通过 subPath 挂载的文件不会自动接收这类更新。

bash
kubectl patch configmap file-config --type merge -p '{"data":{"app.yaml":"server:\n  port: 9090\n"}}'
sleep 70
POD=$(kubectl get pod -l app=config-file-demo -o jsonpath='{.items[0].metadata.name}')
kubectl exec "$POD" -- sh -c 'printf "[directory]\n"; cat /etc/demo/app.yaml; printf "[subPath]\n"; cat /etc/app.yaml'

预期输出:

text
configmap/file-config patched
[directory]
server:
  port: 9090
[subPath]
server:
  port: 8080

实际同步时间可能不同。若目录文件仍未变化,应继续等待并确认 Pod 使用的确实是当前 ConfigMap;不要把固定的等待秒数当作生产环境重载协议。

选择与排错要点

需要整组配置并希望后续更新可见时,优先挂载目录。只有应用必须在固定路径读取单个文件,而且配置变化可以通过重建 Pod 生效时,才使用 subPath。

出现 CreateContainerConfigError 时,先检查 ConfigMap 名称和 items.key 是否存在。文件路径不符合预期时,再检查 items.path、挂载目录和 subPath 是否完全一致。配置文件存在但应用仍读取旧值时,要确认应用是否缓存了配置,而不是只检查文件内容。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置文件挂载

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

登录哪都通