容器与云原生 / 系统课时

注入环境变量

注入环境变量

容器经常需要知道自身名称、Pod IP 或已分配的 CPU 与内存。本课用一个 Pod 同时演示固定值、字段引用和资源字段引用,并通过日志确认注入结果。

学习目标

  • 使用 value 注入固定环境变量。
  • 使用 fieldRef 读取 Pod 字段。
  • 使用 resourceFieldRef 读取容器资源配额。

三种注入来源

固定值适合环境名称、功能开关等静态配置;fieldRef 通过 Downward API 暴露 Pod 元数据或状态;resourceFieldRef 则把当前容器的 CPU、内存请求量或限制量转换为环境变量。

写法 数据来源 典型用途
value 清单中的固定字符串 环境标识、开关
fieldRef Pod 字段 Pod 名称、命名空间、Pod IP
resourceFieldRef 容器资源配置 CPU 请求量、内存限制量

这些值会在容器启动时注入进程环境,应用只需按普通环境变量读取,不必直接调用 Kubernetes API。

创建演示 Pod

将下面内容保存为 env-pod.yaml。示例把 CPU 换算为毫核,把内存换算为 MiB,便于程序直接使用整数值。

yaml
apiVersion: v1
kind: Pod
metadata:
  name: env-demo
spec:
  restartPolicy: Never
  containers:
    - name: app
      image: busybox:1.36
      command:
        - sh
        - -c
        - |
          printf 'APP_ENV=%s\n' "$APP_ENV"
          printf 'POD_NAME=%s\n' "$POD_NAME"
          printf 'POD_IP=%s\n' "$POD_IP"
          printf 'CPU_REQUEST_M=%s\n' "$CPU_REQUEST_M"
          printf 'MEMORY_LIMIT_MI=%s\n' "$MEMORY_LIMIT_MI"
          sleep 300
      resources:
        requests:
          cpu: 250m
          memory: 64Mi
        limits:
          cpu: 500m
          memory: 128Mi
      env:
        - name: APP_ENV
          value: practice
        - name: POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        - name: POD_IP
          valueFrom:
            fieldRef:
              fieldPath: status.podIP
        - name: CPU_REQUEST_M
          valueFrom:
            resourceFieldRef:
              containerName: app
              resource: requests.cpu
              divisor: 1m
        - name: MEMORY_LIMIT_MI
          valueFrom:
            resourceFieldRef:
              containerName: app
              resource: limits.memory
              divisor: 1Mi

divisor 决定换算单位:250m ÷ 1m = 250,128Mi ÷ 1Mi = 128。配置文件生效后,可通过容器日志验证所有值。

部署并验证

执行以下命令创建 Pod,等待容器就绪,再读取启动日志。

bash
kubectl apply -f env-pod.yaml
kubectl wait --for=condition=Ready pod/env-demo --timeout=60s
kubectl logs env-demo

预期输出如下,其中 <POD_IP> 由集群动态分配,实际值可能不同。

text
pod/env-demo created
pod/env-demo condition met
APP_ENV=practice
POD_NAME=env-demo
POD_IP=<POD_IP>
CPU_REQUEST_M=250
MEMORY_LIMIT_MI=128

关键边界

fieldRef 只能读取 Kubernetes 支持的字段,不能把任意 YAML 路径写进 fieldPath。resourceFieldRef 读取的是指定容器的请求量或限制量,资源项未配置时不要假定一定能得到业务需要的默认值。

环境变量在容器启动时确定,不会随着 Pod 标签、注解或资源配置变化而实时刷新。需要更新时,应修改清单并重新创建或滚动替换 Pod。

本课总结

  • value 用于固定值,fieldRef 用于 Pod 字段,resourceFieldRef 用于容器资源值。
  • divisor 可以把 CPU 和内存数量转换成应用易处理的单位。
  • 注入值属于启动时快照,配置变化后通常需要重建容器。

下一课预告

下一课将把多个容器放进同一个 Pod,利用共享网络与共享卷实现 Sidecar 协作。

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

目录与阅读设置

阅读设置

17

记录一个想法

注入环境变量

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

登录哪都通