容器与云原生 / 系统课时
注入环境变量
注入环境变量
容器经常需要知道自身名称、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: 1Midivisor 决定换算单位: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 协作。
按自己的节奏,确认真正理解。