首页/云/Kubernetes 速查/ConfigMap 注入环境变量(env/envFrom)
配置与存储54 条

ConfigMap 注入环境变量(env/envFrom)

把配置以环境变量注入容器:单键用 valueFrom.configMapKeyRef,整集合用 envFrom;注入发生在容器启动时,运行中不更新。

Kubernetes 速查云更新于 2026-10-12

env 与 envFrom 示例

env 与 envFrom 示例
containers:
  - name: app
    image: registry.example.com/app:1.26.0
    env:
      - name: LOG_LEVEL
        valueFrom:
          configMapKeyRef:
            name: app-config
            key: LOG_LEVEL
    envFrom:
      - configMapRef:
          name: app-config
      - configMapRef:
          name: feature-flags
          optional: true

验证

验证
kubectl exec -it web-x -- env | grep -E 'LOG_LEVEL|MAX_CONN'
envFrom 把 ConfigMap 所有键注入为变量;同名变量时 env 显式声明优先于 envFrom。

易错点

  • 键含连字符/点号时不能直接作为环境变量名(被跳过),此时应改用卷挂载
  • Pod 启动后 ConfigMap 更新不会反映到已有环境变量,需重建 Pod

数据来源与参考

  • Kubernetes 官方文档 · ConfigMap(Using ConfigMaps)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌