Kubernetes ConfigMap 配置详解：从创建到Pod应用

Kubernetes ConfigMap 配置详解：从创建到Pod应用

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website

概述

在现代应用开发中，配置管理是一个关键环节。Kubernetes 提供了 ConfigMap 这一资源对象，专门用于将配置数据与容器镜像解耦，从而实现更灵活的配置管理。本文将深入讲解 ConfigMap 的创建方法以及在 Pod 中的各种使用方式。

ConfigMap 基础概念

ConfigMap 是 Kubernetes 中用于存储非机密数据的资源对象，它允许你将配置信息与容器镜像分离，从而提高应用的可移植性。通过 ConfigMap，你可以：

• 集中管理不同环境（开发、测试、生产）的配置
• 在不重建容器镜像的情况下修改应用配置
• 实现配置的热更新（部分场景支持）

ConfigMap 创建方法

1. 从目录创建

当需要将整个目录下的配置文件打包成 ConfigMap 时：

# 创建示例目录和文件
mkdir -p configmap-demo/
echo "enemies=aliens" > configmap-demo/game.properties
echo "color=blue" > configmap-demo/ui.properties

# 从目录创建ConfigMap
kubectl create configmap game-config --from-file=configmap-demo/

此方法会将目录下所有有效文件作为 ConfigMap 的数据项，文件名作为键，文件内容作为值。

2. 从单个或多个文件创建

可以指定具体文件来创建 ConfigMap：

kubectl create configmap specific-config \
  --from-file=configmap-demo/game.properties \
  --from-file=configmap-demo/ui.properties

3. 从环境变量文件创建

对于标准的 .properties 格式文件：

kubectl create configmap env-config \
  --from-env-file=configmap-demo/game.properties

4. 从字面值创建

直接通过命令行指定键值对：

kubectl create configmap literal-config \
  --from-literal=special.how=very \
  --from-literal=special.type=charm

5. 使用 Kustomize 生成

对于更复杂的场景，可以使用 Kustomize：

# kustomization.yaml
configMapGenerator:
- name: generated-config
  literals:
  - SPECIAL_TYPE=charm
  - SPECIAL_HOW=very

然后应用配置：

kubectl apply -k .

在 Pod 中使用 ConfigMap

1. 作为环境变量

单个环境变量

apiVersion: v1
kind: Pod
metadata:
  name: configmap-demo
spec:
  containers:
    - name: demo-container
      image: busybox
      command: ["/bin/sh", "-c", "echo $SPECIAL_LEVEL_KEY"]
      env:
        - name: SPECIAL_LEVEL_KEY
          valueFrom:
            configMapKeyRef:
              name: special-config
              key: special.how

多个环境变量

env:
- name: SPECIAL_LEVEL_KEY
  valueFrom:
    configMapKeyRef:
      name: special-config
      key: special.how
- name: LOG_LEVEL
  valueFrom:
    configMapKeyRef:
      name: env-config
      key: log_level

2. 全部键值作为环境变量

envFrom:
- configMapRef:
    name: special-config

3. 在容器命令中使用

command: ["/bin/sh", "-c", "echo $(SPECIAL_LEVEL_KEY)"]

最佳实践与注意事项

1. 命名规范：ConfigMap 名称必须符合 DNS 子域名规范
2. 文件命名：用于创建 ConfigMap 的文件名只能包含字母、数字、'-'、'_'或'.'
3. 大小限制：ConfigMap 数据大小不能超过 1MiB
4. 热更新：ConfigMap 更新后，已挂载的 Pod 需要重启才能获取新配置
5. 敏感数据：对于敏感信息，应使用 Secret 而非 ConfigMap

总结

ConfigMap 是 Kubernetes 配置管理的核心组件之一。通过本文的详细讲解，你应该已经掌握了从创建 ConfigMap 到在 Pod 中使用的完整流程。合理使用 ConfigMap 可以大大提高应用的可配置性和可维护性，是 Kubernetes 应用开发中不可或缺的技能。

website Kubernetes website and documentation repo: 项目地址: https://gitcode.com/gh_mirrors/webs/website