在 Kubernetes（k8s）中，metadata是资源对象（如 Pod、Deployment、Service 等）的核心组成部分，用于唯一标识资源并附加描述性信息。它类似于资源的 “名片”，包含了资源的名称、命名空间、标签、注释等关键属性。
一、metadata的核心作用
- 唯一标识资源
通过name和namespace确保资源在集群中的唯一性。 - 分类和筛选
使用labels对资源进行分组（如按环境、功能、团队分类）。 - 附加描述信息
通过annotations存储非标识性元数据（如构建信息、运维指南）。 - 版本控制
resourceVersion和uid用于跟踪资源变更和唯一标识。
二、metadata的常见字段
1. 必选字段
name
资源的名称，必须在命名空间内唯一（如nginx-pod）。
metadata: name: my-pod
namespace
资源所属的命名空间（默认default）。
metadata: namespace: production
2. 标签（labels）
用于对资源进行分类的键值对，常用于选择器（Selector）和监控。
metadata:
labels:
app: nginx
env: production
tier: frontend
3. 注释（annotations）
存储非标识性元数据（如构建版本、文档链接、工具配置），不用于筛选。
metadata:
annotations:
buildVersion: "v1.2.3"
documentation: "https://example.com/docs"
kubernetes.io/change-cause: "Update to latest version"
4. 其他字段
uid
Kubernetes 自动生成的全局唯一标识符（如123e4567-e89b-12d3-a456-426614174000）。resourceVersion
资源的内部版本号，每次修改时递增（用于并发控制）。creationTimestamp
资源创建的时间戳。
四、实战示例
以下是一个 Pod 的metadata完整示例：
apiVersion: v1
kind: Pod
metadata:
name: my-app-pod
namespace: production
labels:
app: my-app
env: production
tier: backend
annotations:
buildVersion: "v2.0.1"
created-by: "jenkins-pipeline"
documentation: "https://internal/docs/my-app"
spec:
containers:
- name: app-container
image: my-app:v2.0.1
五、为什么metadata如此重要？
- 资源管理
通过标签快速筛选资源（如kubectl get pods -l env=dev）。 - 自动化部署
CI/CD 工具通过注释注入构建信息（如版本号、提交哈希）。 - 监控和告警
监控系统基于标签聚合指标（如按app和env分组）。 - 生命周期管理
uid和resourceVersion确保资源变更的原子性和唯一性。