ConfigMap 基础：定义、创建方式与 Pod 关联

ConfigMap 是 Kubernetes 中用于将非机密性配置数据与 Pod 解耦的核心 API 对象。它允许你将环境变量、命令行参数或配置文件从容器镜像中抽离出来，从而实现配置的集中管理与动态更新。理解 ConfigMap 的基础概念是分析缓存命中率问题的前提——因为缓存失效往往与 ConfigMap 的挂载方式、更新机制及 Pod 的重建策略直接相关。

2.1 ConfigMap 定义与数据结构

ConfigMap 本质上是一个键值对（key-value）存储结构，支持存储单个值、多行文本或二进制数据（通过 binaryData 字段）。其核心字段如下：

2.2 三种创建方式

Kubernetes 提供三种创建 ConfigMap 的方式，适用于不同的运维场景：

1. kubectl create configmap 命令式创建：适合快速测试或临时配置。
2. YAML 声明式创建：适合版本管理与 CI/CD 集成。
3. 从文件/目录/字面值创建：适合批量导入现有配置文件。

# YAML 声明式示例：app-config.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: default
data:
  APP_ENV: "production"
  APP_LOG_LEVEL: "info"
  nginx.conf: |
    server {
      listen 80;
      server_name example.com;
    }

2.3 与 Pod 的关联方式

ConfigMap 通过两种主要方式注入到 Pod 中：环境变量和卷挂载。两种方式在缓存行为上存在显著差异，直接影响 ConfigMap 的更新传播效率。

2.3.1 环境变量方式

将 ConfigMap 中的键值对映射为 Pod 容器的环境变量。Pod 启动时，kubelet 从 API Server 拉取 ConfigMap 数据并注入到容器进程环境。

# Pod 定义：通过 envFrom 注入整个 ConfigMap
apiVersion: v1
kind: Pod
metadata:
  name: app-pod
spec:
  containers:
  - name: app
    image: nginx:1.25
    envFrom:
    - configMapRef:
        name: app-config
    env:
    - name: SPECIAL_KEY
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: APP_ENV

2.3.2 卷挂载方式

将 ConfigMap 挂载为 Pod 内的一个卷（Volume），容器通过文件系统读取配置。kubelet 会定期（默认 60 秒）同步 ConfigMap 更新到挂载的文件中。

# Pod 定义：通过 volume 挂载 ConfigMap
apiVersion: v1
kind: Pod
metadata:
  name: app-pod-volume
spec:
  containers:
  - name: app
    image: nginx:1.25
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
      readOnly: true
  volumes:
  - name: config-volume
    configMap:
      name: app-config
      items:
      - key: nginx.conf
        path: nginx.conf

2.4 ConfigMap 与 Pod 关联架构图

下图展示了 ConfigMap 的创建、存储与 Pod 关联的完整数据流：

2.5 两种关联方式对比总结