4. ConfigMap 在 Pod 中的使用：环境变量注入、命令行参数注入、卷挂载

ConfigMap 创建完成后，需要通过 Pod 引用才能将配置数据传递给容器。Kubernetes 提供了三种核心注入方式：环境变量注入、命令行参数注入和卷挂载（Volume Mount）。每种方式适用于不同的场景，在数据更新、热加载能力和使用限制上存在显著差异。

4.1 环境变量注入

环境变量注入是最直接的方式，通过 env 字段中的 valueFrom 引用 ConfigMap 中的键值对。Pod 启动时，Kubernetes 将 ConfigMap 中指定 key 的值注入为容器的环境变量。

4.1.1 单键值注入

apiVersion: v1
kind: Pod
metadata:
  name: configmap-env-pod
spec:
  containers:
  - name: app-container
    image: nginx:1.25
    env:
    - name: APP_MODE          # 容器内的环境变量名
      valueFrom:
        configMapKeyRef:
          name: app-config    # ConfigMap 名称
          key: mode           # ConfigMap 中的 key
    - name: LOG_LEVEL
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: log_level
          optional: true      # 可选：如果 key 不存在，Pod 仍可启动

4.1.2 批量注入所有键值对

使用 envFrom 可以将 ConfigMap 中的所有键值对一次性注入为环境变量，适合配置项较多的场景。

apiVersion: v1
kind: Pod
metadata:
  name: configmap-envfrom-pod
spec:
  containers:
  - name: app-container
    image: nginx:1.25
    envFrom:
    - configMapRef:
        name: app-config      # 注入该 ConfigMap 的所有键值对
      prefix: CFG_            # 可选：为所有环境变量添加前缀

4.2 命令行参数注入

命令行参数注入本质上是环境变量注入的延伸。Pod 的 command 或 args 字段中可以使用 $(ENV_VAR_NAME) 语法引用已注入的环境变量，Kubernetes 在启动容器前会完成变量替换。

apiVersion: v1
kind: Pod
metadata:
  name: configmap-args-pod
spec:
  containers:
  - name: app-container
    image: myapp:1.0
    env:
    - name: SERVER_PORT
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: port
    - name: DB_HOST
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: database_host
    args:
    - "--port=$(SERVER_PORT)"
    - "--db-host=$(DB_HOST)"
    - "--log-level=debug"     # 硬编码参数与动态参数可混合使用

4.3 卷挂载（Volume Mount）注入

卷挂载是将 ConfigMap 作为卷挂载到 Pod 的文件系统中。每个 ConfigMap 的 key 会成为一个文件，key 的值作为文件内容。这是最灵活、功能最强大的注入方式。

4.3.1 基本挂载方式

apiVersion: v1
kind: Pod
metadata:
  name: configmap-volume-pod
spec:
  containers:
  - name: app-container
    image: nginx:1.25
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config    # 挂载到容器内的目录
      readOnly: true            # 建议设置为只读，防止容器误修改
  volumes:
  - name: config-volume
    configMap:
      name: app-config          # 引用的 ConfigMap 名称
      items:                    # 可选：只挂载指定的 key
      - key: nginx.conf
        path: nginx.conf        # 挂载后的文件名
      - key: app.properties
        path: properties/app.properties  # 支持子目录
      defaultMode: 0644         # 文件权限，可选

4.3.2 挂载后的文件结构

假设 ConfigMap app-config 包含以下数据：

server { listen 80; }

mode=production
log_level=info

挂载到 /etc/config 后，容器内的文件结构为：

/etc/config/
├── nginx.conf          # 内容：server { listen 80; }
├── app.properties      # 内容：mode=production\nlog_level=info
└── redis.host          # 内容：redis-svc.default.svc.cluster.local

4.3.3 子路径挂载（subPath）

当需要将 ConfigMap 中的某个 key 挂载到已有目录的特定文件时，使用 subPath 可以避免覆盖整个目录。

volumeMounts:
- name: config-volume
  mountPath: /etc/nginx/nginx.conf    # 挂载到具体文件路径
  subPath: nginx.conf                 # 只挂载 ConfigMap 中的 nginx.conf key
  readOnly: true

4.4 三种注入方式对比

4.5 实战案例：Nginx 配置热更新

以下示例展示如何使用卷挂载方式实现 Nginx 配置的热更新，无需重启 Pod。

4.5.1 创建 ConfigMap 包含 Nginx 配置

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-config
data:
  nginx.conf: |
    events {
      worker_connections 1024;
    }
    http {
      server {
        listen 80;
        location / {
          root /usr/share/nginx/html;
          index index.html;
        }
      }
    }

4.5.2 部署 Pod 挂载配置

apiVersion: v1
kind: Pod
metadata:
  name: nginx-hotreload
spec:
  containers:
  - name: nginx
    image: nginx:1.25
    volumeMounts:
    - name: nginx-config-vol
      mountPath: /etc/nginx/nginx.conf
      subPath: nginx.conf
      readOnly: true
    lifecycle:
      postStart:
        exec:
          command: ["/bin/sh", "-c", "nginx -s reload"]
  volumes:
  - name: nginx-config-vol
    configMap:
      name: nginx-config
      items:
      - key: nginx.conf
        path: nginx.conf

4.6 常见问题与避坑指南

• 环境变量注入后无法热更新：环境变量在 Pod 启动时一次性注入，后续 ConfigMap 更新不会影响运行中的 Pod。必须通过 kubectl rollout restart 或更新 Deployment 触发滚动更新。
• 卷挂载更新延迟：Kubelet 默认每 10 秒同步一次 ConfigMap 变更。如果应用需要更快的响应，可以考虑使用 fs.inotify.max_user_watches 或第三方工具。
• subPath 不支持热更新：使用 subPath 挂载时，ConfigMap 更新后不会同步到容器内文件。如果需要热更新，必须使用完整的卷挂载路径。
• ConfigMap 大小限制：etcd 默认单个资源大小限制为 1.5MB。如果配置数据超过此限制，建议使用 Secret 或外部配置中心（如 Consul、Spring Cloud Config）。
• 环境变量命名冲突：使用 envFrom 批量注入时，如果 ConfigMap 的 key 包含非法字符（如连字符、点号），Kubernetes 会跳过该 key 并记录事件。建议 ConfigMap 的 key 使用下划线命名。