☸️ Kubernetes ConfigMap: 如何完美分离配置与代码

5 月 27, 2026

—

cslab

in IT Security

大家好！今天我们将深入探讨ConfigMap，它是Kubernetes操作的核心要素之一。在部署应用程序时，我们如何智能地管理随环境变化的配置值呢？现在就开始吧！🚀

1. 什么是ConfigMap？🤔

ConfigMap是Kubernetes API资源，用于以键值对的形式存储非机密数据。

如果在应用程序源代码中硬编码数据库连接信息或API端点等配置值，那么每次环境变化时都必须重新构建镜像，这非常麻烦。ConfigMap通过将配置信息与容器镜像分离来解决这个问题。

💡 核心要点:

分离: 分离代码和配置，提高可移植性。

– 灵活性: 无需重新编译应用程序即可更改配置。

– 用途: 用作环境变量、命令行参数或卷中的配置文件。

2. 创建ConfigMap 🛠️

创建ConfigMap主要有两种方法：直接使用kubectl命令和定义YAML文件。

A. 使用kubectl命令创建 (命令式)

您可以通过一行命令直接从文件、目录或特定值创建ConfigMap。

# 从字面值创建
kubectl create configmap my-config --from-literal=ui_color="blue" --from-literal=log_level="info"

# 从文件创建
kubectl create configmap app-config --from-file=config.properties

B. 使用YAML文件定义 (声明式)

这是最推荐的方法。它易于版本控制且清晰明了。

apiVersion: v1
kind: ConfigMap
metadata:
  name: game-demo
data:
  # 属性风格的键；每个键映射到一个简单值
  player_initial_lives: "3"
  ui_properties_file_name: "user-interface.properties"
  
  # 文件风格的键
  game.properties: |
    enemy.types=aliens,monsters
    player.maximum-lives=5

3. 将ConfigMap连接到容器 🔗

将创建的ConfigMap应用到Pod内部容器的方法主要有三种。

① 作为环境变量注入

将特定键的值作为容器的环境变量获取。

apiVersion: v1
kind: Pod
metadata:
  name: configmap-pod
spec:
  containers:
    - name: test-container
      image: k8s.gcr.io/busybox
      command: [ "/bin/sh", "-c", "env" ]
      env:
        # 将键'player_initial_lives'的值分配给'INITIAL_LIVES'环境变量
        - name: INITIAL_LIVES
          valueFrom:
            configMapKeyRef:
              name: game-demo
              key: player_initial_lives

② 将ConfigMap的所有数据作为环境变量注入

使用envFrom可以一次性获取ConfigMap中的所有数据。

spec:
  containers:
    - name: test-container
      image: k8s.gcr.io/busybox
      envFrom:
        - configMapRef:
            name: game-demo

③ 作为卷(Volume)挂载

这种方法将配置文件本身以文件形式嵌入到特定路径。在处理大型配置文件（例如nginx.conf）时非常有用。

apiVersion: v1
kind: Pod
metadata:
  name: configmap-volume-pod
spec:
  containers:
    - name: test-container
      image: nginx
      volumeMounts:
      - name: config-volume
        mountPath: /etc/config
  volumes:
    - name: config-volume
      configMap:
        name: game-demo

4. 注意事项 ⚠️

大小限制: ConfigMap不能超过1MiB。对于大容量数据，应考虑其他存储选项。
安全性: ConfigMap以纯文本形式存储。对于密码或API密钥等敏感信息，务必使用Secret资源。
更新: 作为卷挂载的ConfigMap在值更改时会自动更新容器内部文件，但作为环境变量注入的值需要重启Pod才能生效。

总结 🎁

ConfigMap是构建云原生应用程序不可或缺的工具。灵活管理特定环境的配置，以创建更安全、更高效的部署管道！