1. ConfigMap 基础概念

1.1 什么是 ConfigMap

ConfigMap 是 Kubernetes 中用于将非机密性配置数据与容器镜像解耦的 API 对象。它允许你将环境变量、命令行参数、配置文件等内容从 Pod 定义中分离出来，实现配置的集中管理和动态更新。

1.2 ConfigMap 与 Secret 的核心区别

1.3 ConfigMap 在 Kubernetes 中的定位

ConfigMap 位于 Kubernetes 配置管理体系的中间层，连接着声明式 API 与容器运行时。它不直接运行进程，而是作为数据源被 Pod 引用。

1.4 ConfigMap 的典型使用场景

• 环境差异化配置：开发、测试、生产环境使用不同的 ConfigMap，同一镜像无需重新构建。
• 应用配置文件注入：将 nginx.conf、application.yml 等配置文件以 Volume 方式挂载到 Pod 中。
• 容器环境变量定义：通过 envFrom 将 ConfigMap 中所有键值对批量注入为环境变量。
• 命令行参数拼接：结合 $(VAR_NAME) 语法，在 Pod 的 command 中引用 ConfigMap 数据。
• Sidecar 配置共享：同一 Pod 内多个容器共享同一个 ConfigMap Volume。

1.5 ConfigMap 的创建方式

1.6 ConfigMap 的 YAML 结构

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: default
data:
  # 键值对形式
  APP_ENV: "production"
  LOG_LEVEL: "info"
  
  # 多行配置文件形式
  nginx.conf: |
    server {
      listen 80;
      server_name example.com;
    }
  
  # 结构化数据
  app.properties: |
    db.host=localhost
    db.port=5432

1.7 ConfigMap 的不可变特性

从 Kubernetes 1.21 开始，ConfigMap 支持不可变（Immutable）标记。一旦设置 immutable: true，该 ConfigMap 的数据将无法修改，只能删除重建。

apiVersion: v1
kind: ConfigMap
metadata:
  name: immutable-config
immutable: true  # 启用不可变特性
data:
  app.version: "2.5.0"
  feature.flag: "enabled"

1.8 常见误区与避坑指南

• 误区一：ConfigMap 可以存储任意大小的数据。→ 事实：etcd 默认限制 1.5 MiB 单对象大小，ConfigMap 建议不超过 1 MiB。
• 误区二：更新 ConfigMap 后所有 Pod 自动热加载。→ 事实：环境变量方式不会自动更新；Volume 挂载方式有同步延迟（默认约 60 秒）。
• 误区三：ConfigMap 可以跨命名空间引用。→ 事实：ConfigMap 是命名空间级别的资源，只能被同一命名空间内的 Pod 引用。
• 误区四：ConfigMap 数据在 etcd 中是加密的。→ 事实：ConfigMap 默认明文存储，如需加密应使用 Secret 或启用 etcd 静态加密。