容器与云原生 / 系统课时
环境变量配置
环境变量配置
本课解决“同一镜像如何在不同 Pod 和环境中获得不同配置”的问题。你将把固定值、Pod 元数据、资源限制和 ConfigMap 内容注入环境变量,并验证容器实际读取到的结果。
学习目标
- 区分
env、envFrom与valueFrom的适用场景 - 从 Pod 字段、资源字段和 ConfigMap 注入环境变量
- 解释变量覆盖、缺失引用和配置更新的运行边界
环境变量的来源
env 适合逐项声明变量,可以直接写固定值,也可以通过 valueFrom 引用其他来源。envFrom 会批量导入 ConfigMap 或 Secret 中的键,适合键名已经按环境变量规则设计好的配置集合。
常见来源包括固定字符串、Downward API 暴露的 Pod 字段、容器资源请求或限制,以及 ConfigMap、Secret 中的指定键。Kubelet 在创建容器时解析这些来源,并把结果交给容器主进程。

主示例:组合多种变量来源
先创建 ConfigMap,再创建 Pod。容器启动后会打印固定值、Pod 字段、CPU 限制和批量导入的配置。
apiVersion: v1
kind: ConfigMap
metadata:
name: app-env
data:
COLOR: blue
LOG_LEVEL: info
---
apiVersion: v1
kind: Pod
metadata:
name: env-demo
spec:
restartPolicy: Never
containers:
- name: demo
image: busybox:1.36
resources:
limits:
cpu: 250m
env:
- name: APP_MODE
value: production
- name: POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
- name: POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
- name: CPU_LIMIT_MILLICORES
valueFrom:
resourceFieldRef:
resource: limits.cpu
divisor: 1m
- name: APP_COLOR
valueFrom:
configMapKeyRef:
name: app-env
key: COLOR
envFrom:
- prefix: CFG_
configMapRef:
name: app-env
command: ["/bin/sh", "-c"]
args:
- |
echo "APP_MODE=$APP_MODE"
echo "POD_NAME=$POD_NAME"
echo "POD_NAMESPACE=$POD_NAMESPACE"
echo "CPU_LIMIT_MILLICORES=$CPU_LIMIT_MILLICORES"
echo "APP_COLOR=$APP_COLOR"
env | grep '^CFG_' | sort将内容保存为 env-demo.yaml,执行并查看日志。
kubectl apply -f env-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Succeeded pod/env-demo --timeout=60s
kubectl logs env-demo预期输出:
configmap/app-env created
pod/env-demo created
pod/env-demo condition met
APP_MODE=production
POD_NAME=env-demo
POD_NAMESPACE=default
CPU_LIMIT_MILLICORES=250
APP_COLOR=blue
CFG_COLOR=blue
CFG_LOG_LEVEL=info若在非 default 命名空间执行,POD_NAMESPACE 会显示实际命名空间。resourceFieldRef 的结果仍是字符串;这里通过 divisor: 1m 把 250m 表示为 250。
覆盖规则与更新边界
同名变量同时来自 env 和 envFrom 时,显式列出的 env 优先。多个 envFrom 来源产生同名键时,后面的来源覆盖前面的来源。为了减少隐式冲突,生产清单应使用清晰前缀,并避免在多个配置对象中重复键名。
value 与 valueFrom 不能同时出现在同一个变量项中。引用的 ConfigMap、Secret 或键不存在且未声明为可选时,容器无法正常创建;排查时应查看 Pod 事件,而不是只等待应用日志。
环境变量只在容器创建时注入。之后修改 ConfigMap 或 Secret,不会刷新已经运行进程中的变量,需要通过滚动更新、删除 Pod 或修改 Pod 模板触发重建。敏感值即使来自 Secret,也不应写入日志或错误页面。
何时使用 env 与 envFrom
少量关键变量使用 env 更容易审查,也能为每个变量明确来源。配置项很多且键名稳定时,可以用 envFrom 批量导入;加上 prefix 能降低与镜像内置变量冲突的概率。
需要把配置作为文件读取、希望更新后由应用自行重新加载,或内容包含多行文本时,卷挂载通常比环境变量更合适。环境变量适合较短、启动时读取且不需要热更新的值。