容器与云原生 / 系统课时

环境变量配置

环境变量配置

本课解决“同一镜像如何在不同 Pod 和环境中获得不同配置”的问题。你将把固定值、Pod 元数据、资源限制和 ConfigMap 内容注入环境变量,并验证容器实际读取到的结果。

学习目标

  • 区分 env、envFrom 与 valueFrom 的适用场景
  • 从 Pod 字段、资源字段和 ConfigMap 注入环境变量
  • 解释变量覆盖、缺失引用和配置更新的运行边界

环境变量的来源

env 适合逐项声明变量,可以直接写固定值,也可以通过 valueFrom 引用其他来源。envFrom 会批量导入 ConfigMap 或 Secret 中的键,适合键名已经按环境变量规则设计好的配置集合。

常见来源包括固定字符串、Downward API 暴露的 Pod 字段、容器资源请求或限制,以及 ConfigMap、Secret 中的指定键。Kubelet 在创建容器时解析这些来源,并把结果交给容器主进程。

环境变量来源与注入关系

主示例:组合多种变量来源

先创建 ConfigMap,再创建 Pod。容器启动后会打印固定值、Pod 字段、CPU 限制和批量导入的配置。

yaml
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,执行并查看日志。

bash
kubectl apply -f env-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Succeeded pod/env-demo --timeout=60s
kubectl logs env-demo

预期输出:

text
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 能降低与镜像内置变量冲突的概率。

需要把配置作为文件读取、希望更新后由应用自行重新加载,或内容包含多行文本时,卷挂载通常比环境变量更合适。环境变量适合较短、启动时读取且不需要热更新的值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

环境变量配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通