首页/云/Kubernetes 速查/Downward API 注入 Pod 元数据
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条
配置与存储54 条
调度与资源52 条集群运维与排障54 条

Downward API 注入 Pod 元数据

把 Pod 名称、命名空间、IP、节点名、资源限制等通过环境变量暴露给容器,无需访问 API Server;日志打标与自注册脚本常用。

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

env 引用示例

env 引用示例
env:
  - name: MY_POD_NAME
    valueFrom:
      fieldRef:
        fieldPath: metadata.name
  - name: MY_NODE_NAME
    valueFrom:
      fieldRef:
        fieldPath: spec.nodeName
  - name: MY_POD_IP
    valueFrom:
      fieldRef:
        fieldPath: status.podIP
  - name: MY_CPU_LIMIT
    valueFrom:
      resourceFieldRef:
        containerName: app
        resource: limits.cpu

常用 fieldPath

字段含义
metadata.namePod 名
metadata.namespace命名空间
spec.nodeName所在节点名
status.podIPPod IP
status.hostIP节点 IP
metadata.labels['app']指定标签的值

易错点

  • env 形式在容器启动时固定,运行中标签/注解变化不会更新(卷形式才周期同步)
  • resourceFieldRef 要写容器名与 limits./requests. 前缀,缺前缀直接报错

数据来源与参考

  • Kubernetes 官方文档 · Downward API
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌