📚 课程目录第2章 ConfigMap创建方式

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

在 Kubernetes 中，ConfigMap 的创建方式灵活多样，覆盖了从开发调试到生产交付的全场景。本章将系统讲解四种创建方式：kubectl 命令行、YAML 文件、从文件/目录、从字面量。每种方式都有其适用场景和最佳实践，掌握它们能让你在云原生配置管理中游刃有余。

💡 核心原则： 选择创建方式时，优先考虑可重复性和版本控制能力。YAML 文件方式最适合生产环境，命令行和字面量方式适合快速验证，文件/目录方式适合批量导入配置。

2.1 使用 kubectl 命令行创建

kubectl create configmap 命令是最直接的创建方式，适合快速验证和临时场景。其基本语法如下：

# 基本语法
kubectl create configmap <name> [--from-literal=key=value] [--from-file=path] [--from-env-file=path] [--dry-run=client]

  🔑 关键参数说明：
  --from-literal：直接指定键值对，可重复使用
--from-file：从文件导入，文件名作为 key
--from-env-file：从 .env 格式文件导入
--dry-run=client -o yaml：预览生成的 YAML，不实际创建

实战示例： 创建一个包含应用配置的 ConfigMap：

# 创建名为 app-config 的 ConfigMap，包含两个键值对
kubectl create configmap app-config \
  --from-literal=APP_ENV=production \
  --from-literal=LOG_LEVEL=info

# 预览生成的 YAML（推荐先预览再创建）
kubectl create configmap app-config \
  --from-literal=APP_ENV=production \
  --from-literal=LOG_LEVEL=info \
  --dry-run=client -o yaml

⚠️ 注意： 使用 --dry-run=client -o yaml 是生产环境的最佳实践。它允许你在创建前检查生成的配置，避免因拼写错误导致配置异常。这个技巧在蓝绿发布和剧本发布包校验中尤为重要。

2.2 使用 YAML 文件创建

YAML 文件方式是生产环境的标准做法。它遵循声明式管理原则，配置即代码（Configuration as Code），便于版本控制和审计。

YAML 文件结构：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: default
  labels:
    app: myapp
    environment: production
data:
  APP_ENV: production
  LOG_LEVEL: info
  config.yaml: |
    server:
      port: 8080
      timeout: 30s
    database:
      host: db.example.com
      port: 5432

创建命令：

# 从 YAML 文件创建
kubectl apply -f configmap.yaml

# 批量创建多个 ConfigMap
kubectl apply -f ./configmaps/

📋 最佳实践： YAML 文件应纳入 Git 仓库管理。在蓝绿发布场景中，不同版本的 ConfigMap 可以通过不同的 YAML 文件区分，例如 configmap-blue.yaml 和 configmap-green.yaml，确保版本隔离。

2.3 从文件/目录创建

当配置以文件形式存在时（如 .conf、.properties、.json 等），使用 --from-file 或 --from-env-file 可以批量导入，保持文件结构。

方式一：从单个文件创建

# 文件内容：redis.conf
# maxmemory 256mb
# timeout 3000

# 创建 ConfigMap，文件名作为 key，文件内容作为 value
kubectl create configmap redis-config --from-file=redis.conf

# 指定自定义 key
kubectl create configmap redis-config --from-file=custom-key=redis.conf

方式二：从目录创建

# 目录结构：
# ./configs/
#   ├── app.properties
#   ├── logback.xml
#   └── db.json

# 批量导入整个目录
kubectl create configmap app-configs --from-file=./configs/

方式三：从 .env 文件创建

# .env 文件内容：
# DATABASE_URL=postgres://user:pass@localhost:5432/db
# CACHE_TTL=3600

kubectl create configmap env-config --from-env-file=.env

  📊 三种文件导入方式对比：
  
        导入方式
        语法
        key 来源
        适用场景
      
        --from-file（单文件）
        --from-file=path
        文件名（可自定义）
        单个配置文件
      
        --from-file（目录）
        --from-file=dir/
        目录内文件名
        批量导入多个配置
      
        --from-env-file
        --from-env-file=path
        .env 文件中的变量名
        环境变量风格配置

导入方式	语法	key 来源	适用场景
`--from-file`（单文件）	`--from-file=path`	文件名（可自定义）	单个配置文件
`--from-file`（目录）	`--from-file=dir/`	目录内文件名	批量导入多个配置
`--from-env-file`	`--from-env-file=path`	.env 文件中的变量名	环境变量风格配置

2.4 从字面量创建

字面量方式通过 --from-literal 参数直接指定键值对，适合少量配置项或快速原型开发。

# 单个键值对
kubectl create configmap my-config --from-literal=KEY=VALUE

# 多个键值对（推荐方式）
kubectl create configmap my-config \
  --from-literal=APP_NAME=myapp \
  --from-literal=APP_VERSION=1.0.0 \
  --from-literal=DEBUG=false

# 混合使用：字面量 + 文件
kubectl create configmap hybrid-config \
  --from-literal=ENV=staging \
  --from-file=app.properties

⚠️ 避坑指南：

字面量方式不适合存储大量配置（超过 10 个键值对建议改用 YAML 文件）
特殊字符（如 $、\、"）需要转义，建议用单引号包裹
字面量方式无法直接表达多行文本，如需多行配置请使用 --from-file

2.5 四种创建方式对比总结

创建方式	命令/语法	可版本控制	适合场景	推荐指数
kubectl 命令行	`kubectl create configmap`	❌ 否	快速验证、临时测试	⭐⭐⭐
YAML 文件	`kubectl apply -f`	✅ 是	生产环境、CI/CD、GitOps	⭐⭐⭐⭐⭐
从文件/目录	`--from-file` / `--from-env-file`	✅ 是（文件本身）	批量导入、微服务配置	⭐⭐⭐⭐
从字面量	`--from-literal`	❌ 否	少量配置、快速原型	⭐⭐

🎯 实战建议： 在蓝绿发布和剧本发布包校验场景中，推荐使用 YAML 文件方式 作为主要创建手段。将 ConfigMap 的 YAML 文件与发布包一起版本化管理，确保每次发布的配置可追溯、可回滚。同时，结合 --dry-run=client -o yaml 进行预检，是避免配置错误的最后一道防线。