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

Downward API 卷形式

把标签、注解等以文件形式挂进容器并周期同步;适合需要感知自身标签变化的场景,节点名、Pod IP 这类字段则只能走环境变量形式。

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

卷形式示例

卷形式示例
volumes:
  - name: podinfo
    downwardAPI:
      items:
        - path: labels
          fieldRef:
            fieldPath: metadata.labels
        - path: annotations
          fieldRef:
            fieldPath: metadata.annotations

验证

验证
kubectl exec -it web-x -- cat /etc/podinfo/labels
卷形式支持 metadata.name/namespace/labels/annotations;其余字段请用 env 形式。

易错点

  • 卷形式同步存在延迟(分钟级),不能当实时配置通道用
  • 落盘内容是 key="value" 逐行文本,解析程序要按该格式设计

数据来源与参考

  • Kubernetes 官方文档 · Downward API(卷形式)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌