2. ConfigMap 创建方式：四种核心方法详解

ConfigMap 的创建是 Kubernetes 配置管理的基础操作。kubectl 提供了四种创建方式，分别适用于不同的数据来源场景：命令行字面值、单个文件、目录和直接声明式 YAML。理解每种方式的适用场景和底层数据映射规则，是后续进行可视化配置与准入控制的前提。

2.1 四种创建方式对比总览

2.2 字面值创建（--from-literal）

适用于快速注入少量配置项，无需准备外部文件。每个 --from-literal 参数定义一个键值对。

# 创建包含两个配置项的 ConfigMap
kubectl create configmap app-config \
  --from-literal=APP_ENV=production \
  --from-literal=LOG_LEVEL=info

# 查看生成的 YAML
kubectl get configmap app-config -o yaml

输出 YAML 结构：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  APP_ENV: production
  LOG_LEVEL: info

2.3 从文件创建（--from-file）

将整个文件内容作为 ConfigMap 的一个条目。键名默认为文件名，值为文件的完整内容。这是导入配置文件最常用的方式。

# 从单个文件创建
kubectl create configmap nginx-conf \
  --from-file=./nginx.conf

# 自定义键名（覆盖默认文件名）
kubectl create configmap nginx-conf \
  --from-file=my-custom-key=./nginx.conf

文件内容映射示例：

2.4 从目录创建（--from-file 目录）

当配置由多个文件组成时，可以指定目录路径。kubectl 会遍历目录下的所有文件（非递归），每个文件生成一个 data 条目。

# 从目录创建（目录包含多个配置文件）
kubectl create configmap multi-config \
  --from-file=./config-files/

# 查看目录内容
ls ./config-files/
# db.properties
# cache.conf
# logging.yaml

目录创建结果：

apiVersion: v1
kind: ConfigMap
metadata:
  name: multi-config
data:
  db.properties: |
    host=localhost
    port=5432
  cache.conf: |
    max_size=1024
    ttl=300
  logging.yaml: |
    level: info
    format: json

2.5 声明式 YAML 创建（kubectl apply -f）

这是生产环境推荐的方式，支持版本管理、GitOps 和代码审查。YAML 清单可以精确控制 data 字段的键值结构。

# configmap-demo.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-settings
  labels:
    app: my-app
    version: v1.2
data:
  database.url: "jdbc:mysql://db-host:3306/app"
  database.user: "app_user"
  app.feature.flag: "true"
  app.config.json: |
    {
      "timeout": 30,
      "retry": 3,
      "cache": true
    }

# 应用 YAML 创建
kubectl apply -f configmap-demo.yaml

2.6 四种创建方式的数据流与内部映射

下图展示了四种创建方式如何将外部数据转化为 ConfigMap 的 data 字段，并最终挂载到 Pod 中的路径映射关系。

2.7 创建方式选择决策树

根据实际场景选择最合适的创建方式，避免不必要的复杂度：

1. 快速测试/临时配置 → 使用 --from-literal，一行命令即可完成
2. 导入单个配置文件 → 使用 --from-file，保持文件原始格式
3. 批量导入配置集 → 使用 --from-file 指定目录，适合微服务多配置场景
4. 生产环境/版本管理 → 使用声明式 YAML，纳入 Git 仓库管理
5. 需要二进制数据 → 使用声明式 YAML 的 binaryData 字段（如证书、密钥文件）

2.8 验证与调试命令

创建 ConfigMap 后，建议使用以下命令验证数据是否正确：

# 查看 ConfigMap 详细信息
kubectl describe configmap <name>

# 以 YAML 格式查看完整数据
kubectl get configmap <name> -o yaml

# 仅查看 data 字段（JSONPath 方式）
kubectl get configmap <name> -o jsonpath='{.data}'

# 测试挂载效果（临时 Pod）
kubectl run test-pod --image=busybox \
  --rm -it --restart=Never \
  --command -- sh -c "env | grep APP_"