UD5工具箱
ConfigMap 核心概念
ConfigMap
ConfigMap 是 Kubernetes 中用于存储非机密键值对配置数据的 API 资源。它将配置信息与容器镜像解耦，使开发者可以在不重新构建镜像的情况下修改应用配置。ConfigMap 可以存储键值对形式的数据、完整的配置文件内容或者目录结构。ConfigMap 的数据大小限制为 1MB，超出此限制需要考虑其他配置管理方案。ConfigMap 可以通过环境变量注入或 Volume 挂载的方式提供给 Pod 中的容器使用。
ConfigMap vs Secret
ConfigMap 和 Secret 都是 Kubernetes 中用于外部化配置的资源类型，但它们的用途不同。ConfigMap 用于存储非敏感的配置数据，如数据库地址、功能开关、日志级别等，数据以明文形式存储。Secret 用于存储敏感信息，如密码、密钥、证书等，数据以 Base64 编码存储（注意 Base64 编码不是加密）。在安全性要求较高的场景中，建议结合 RBAC 控制对 Secret 的访问权限。如果需要真正的加密存储，可以启用 etcd 加密或使用外部密钥管理服务（如 Vault）。
Immutable ConfigMap（不可变 ConfigMap）
不可变 ConfigMap 是 Kubernetes 1.21+ 引入的特性，通过设置 immutable: true 使 ConfigMap 在创建后不可修改。如果尝试更新不可变 ConfigMap，API 服务器会拒绝请求。不可变 ConfigMap 的主要优势在于：安全性——防止意外或恶意修改配置；性能——kubelet 不需要为不可变 ConfigMap 设置 Watch，减少 API 服务器的负载；一致性——确保所有引用该 ConfigMap 的 Pod 使用相同的配置版本。适用于配置相对稳定且不需要频繁更新的场景。
YAML
YAML（YAML Ain't Markup Language）是一种人类可读的数据序列化格式，Kubernetes 使用 YAML 作为资源定义文件的标准格式。YAML 对缩进非常敏感，使用空格（而非制表符）进行层级划分。一个缩进错误（如混用空格和制表符，或缩进数量不对）就会导致整个配置文件解析失败。Kubernetes 的 YAML 配置文件包含 apiVersion、kind、metadata 和 spec 等标准字段。ConfigMap 的 YAML 中，data 字段存储键值对数据。
kubectl apply
kubectl apply 是 Kubernetes 命令行工具中用于声明式管理资源的命令。通过 kubectl apply -f configmap.yaml 可以创建或更新 ConfigMap。kubectl apply 的特点是"应用"（apply）配置的期望状态：如果资源不存在则创建，如果已存在则根据配置文件中的内容进行更新。与 kubectl create 不同，kubectl apply 支持后续的增量更新。kubectl apply -f - 支持从标准输入读取配置，可以与管道命令结合使用。
Environment Variables（环境变量）
环境变量是操作系统和应用程序运行时使用的动态值。在 Kubernetes 中，可以通过 ConfigMap 将配置数据注入为 Pod 中容器的环境变量。具体方式是在 Pod 定义的 env 字段中使用 valueFrom.configMapKeyRef 引用 ConfigMap 的特定键值对。环境变量方式的优点是简单直观，适合大多数应用；缺点是环境变量更新后，已运行的容器不会自动感知变化，需要重启 Pod。
Volume Mount（卷挂载）
Volume Mount 是 Kubernetes 中将存储卷挂载到容器内指定路径的机制。当 ConfigMap 通过 Volume Mount 方式提供给容器时，ConfigMap 中的每个键会对应创建一个文件，键名是文件名，值是文件内容。卷挂载方式支持热更新——当 ConfigMap 的内容发生变化时，已挂载的文件内容会在一定延迟后自动更新（kubelet 同步周期默认 60 秒）。这种方式适合需要配置文件的应用，如 Nginx 配置文件、Spring Boot 的 application.yml 等。
Namespace（命名空间）
Namespace 是 Kubernetes 中用于逻辑隔离集群资源的机制。每个 Namespace 提供了一个独立的资源作用域，不同 Namespace 中的同名资源互不影响。ConfigMap 是 Namespace 级别的资源，只能被同一 Namespace 中的 Pod 引用。如果需要跨 Namespace 共享配置，需要在每个 Namespace 中创建相同的 ConfigMap，或者使用 ClusterRole 和 RBAC 进行跨 Namespace 访问控制。常见的 Namespace 包括 default、kube-system、kube-public 以及用户自定义的开发、测试和生产环境 Namespace。
Data Size Limit（数据大小限制）
Kubernetes 对 ConfigMap 的数据大小有明确的限制：整个 ConfigMap 对象（包括元数据和数据）的大小不能超过 1MB。这个限制是 etcd 存储层面的限制。如果配置数据超过此限制，需要考虑以下替代方案：将配置拆分为多个 ConfigMap；使用外部配置存储服务（如 Consul、etcd 直接操作）；将大型配置文件存储在持久卷中而非 ConfigMap 中。在实际使用中，大多数应用的配置数据不会超过此限制。
ConfigMap Naming Convention（命名规范）
Kubernetes 资源名称必须符合 DNS 子域名命名规范：由小写字母、数字、连字符（-）和点（.）组成；长度不超过 253 个字符；必须以字母或数字开头和结尾。实际使用中建议采用小写字母、数字和连字符的组合，如 app-name-config 或 app-name-env-config。避免使用大写字母、下划线和特殊字符。命名应具有描述性，能够清晰表达 ConfigMap 的用途和所属应用。