在 Kubernetes (K8s) 中，ConfigMap 是一种用于存储非敏感配置数据的 API 对象。
简单来说，它的核心目的是将应用程序的配置与容器镜像解耦。这意味着你可以在不重新构建镜像的情况下，修改应用的配置（比如数据库地址、日志级别、配置文件内容），让同一个镜像可以在开发、测试和生产环境中复用。
1. 核心概念与特点
- 键值对存储：ConfigMap 本质上是一组键值对（Key-Value）的集合。
- 非敏感数据：它专门用于存储明文配置。如果需要存储密码、Token 或 SSH 密钥等敏感信息，请使用 Secret。
- 解耦：配置不再硬编码在代码或镜像中，而是作为 K8s 资源独立管理。
- 大小限制：单个 ConfigMap 的大小通常限制在 1MB 以内。
2. 创建 ConfigMap 的四种方式
你可以通过命令行或 YAML 文件来创建 ConfigMap。
| 方式 | 命令示例 | 适用场景 |
|---|---|---|
| 1. 命令行指定 | kubectl create configmap my-config --from-literal=key1=val1 --from-literal=key2=val2 |
快速创建简单的键值对配置。 |
| 2. 从文件创建 | kubectl create configmap my-config --from-file=./app.conf |
将现有的配置文件直接导入，键名为文件名。 |
| 3. 从目录创建 | kubectl create configmap my-config --from-file=./config-dir/ |
批量导入目录下的多个配置文件。 |
| 4. YAML 文件 | kubectl apply -f configmap.yaml |
最推荐。适合版本控制（GitOps）和复杂配置管理。 |
YAML 示例 (configmap.yaml):
apiVersion: v1
kind: ConfigMap
metadata:name: app-config
data:# 简单的键值对log_level: "info"app_mode: "production"# 完整的配置文件内容 (使用 | 保留换行)app.properties: |server.port=8080db.url=jdbc:mysql://db-service:3306/mydb
3. 在 Pod 中使用 ConfigMap
ConfigMap 创建后，需要在 Pod 中引用才能生效。主要有两种使用方式：
📥 方式一：作为环境变量注入
适用于应用通过环境变量读取配置的场景。
-
注入单个变量：
env:- name: LOG_LEVELvalueFrom:configMapKeyRef:name: app-configkey: log_level -
注入所有变量：
envFrom:- configMapRef:name: app-config- 特点：容器启动时生效。如果 ConfigMap 更新，环境变量不会自动更新，必须重启 Pod 才能生效。
📂 方式二：作为数据卷挂载
适用于应用需要读取配置文件的场景（如 Nginx 配置文件）。
volumes:- name: config-volumeconfigMap:name: app-config
containers:- name: my-appimage: my-imagevolumeMounts:- name: config-volumemountPath: /etc/config
- 特点：ConfigMap 中的每个键都会变成挂载目录下的一个文件。
- 热更新：如果 ConfigMap 更新，挂载的文件通常会在 1-2 分钟内 自动同步更新（取决于 Kubelet 的同步周期）。但应用本身需要支持热重载（如 Nginx reload）才能读取到新配置。
最佳实践与注意事项
- 命名规范：建议使用
<应用名>-<环境>-config的格式命名，便于区分。 - 更新策略：
- 如果是环境变量注入，更新 ConfigMap 后记得执行
kubectl rollout restart deployment/<name>来重启 Pod。 - 如果是文件挂载，确保你的应用支持监听文件变化或提供 reload 接口。
- 如果是环境变量注入，更新 ConfigMap 后记得执行
- 不要存储大文件：由于 1MB 的限制，不要把大型日志或二进制文件放入 ConfigMap，应使用 PVC（持久卷）。
- 版本控制：尽量通过 YAML 文件管理 ConfigMap，并将其纳入 Git 版本控制，以便追踪配置变更历史。