容器与云原生 / 系统课时
标签、选择器与注解
标签、选择器与注解
本课通过三个可运行的 Pod 演示 Label、Selector 和 Annotation 的分工。你将为资源添加分类信息,用选择器动态筛选对象,再写入不参与筛选的扩展描述,最终形成可供控制器、查询命令和自动化工具共同使用的元数据体系。
学习目标
- 区分标签、选择器与注解的职责。
- 编写等值选择器和集合式选择器。
- 使用
kubectl修改元数据并验证筛选结果。
三类元数据如何协作
Label 是短小、可筛选的键值对,适合表达应用、环境、层级和版本等分类维度。Selector 是匹配规则,本身不存储在被筛选对象中;Service、Deployment 和查询命令都可以使用它选择一组资源。Annotation 用于保存负责人、说明、工具状态等扩展信息,但不参与选择。

| 对象 | 适合保存 | 是否可筛选 |
|---|---|---|
| Label | 应用名、环境、层级、发布批次 | 是 |
| Selector | 一组 Label 的匹配条件 | 用于执行筛选 |
| Annotation | 负责人、审计说明、外部工具信息 | 否 |
标签应表达稳定的分类事实,不要把长文本、时间线日志或频繁变化的大段状态放入 Label。需要扩展描述时,应改用 Annotation,并优先采用带域名前缀的键,例如 training.example.com/owner。
创建带标签和注解的资源
下面的清单创建三个长期运行的 Pod。它们都属于 shop 应用,但层级和环境不同;web-a 还带有一条负责人注解。
# 生产环境的前端 Pod
apiVersion: v1
kind: Pod
metadata:
name: web-a
namespace: label-demo
labels:
app: shop
tier: frontend
env: prod
annotations:
training.example.com/owner: frontend-team
spec:
containers:
- name: worker
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
---
# 测试环境的前端 Pod
apiVersion: v1
kind: Pod
metadata:
name: web-b
namespace: label-demo
labels:
app: shop
tier: frontend
env: test
spec:
containers:
- name: worker
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
---
# 生产环境的后端 Pod
apiVersion: v1
kind: Pod
metadata:
name: api
namespace: label-demo
labels:
app: shop
tier: backend
env: prod
spec:
containers:
- name: worker
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]将文件保存为 labeled-pods.yaml,再创建命名空间并应用清单。等待命令的输出被重定向,只有全部 Pod 就绪后才继续执行筛选。
set -euo pipefail
kubectl create namespace label-demo
kubectl apply -f labeled-pods.yaml
# 只有全部 Pod 就绪后才开始验证选择器
kubectl wait --for=condition=Ready pod --all -n label-demo --timeout=120s >/dev/null
printf 'frontend:\n'
kubectl get pods -n label-demo -l 'app=shop,tier=frontend' -o name
# 多个等值条件按逻辑“与”组合
printf 'prod-frontend:\n'
kubectl get pods -n label-demo -l 'env=prod,tier=frontend' -o name预期输出如下。
namespace/label-demo created
pod/web-a created
pod/web-b created
pod/api created
frontend:
pod/web-a
pod/web-b
prod-frontend:
pod/web-a同一选择器中的多个条件是逻辑“与”。第一个选择器要求同时满足 app=shop 和 tier=frontend,因此返回两个前端 Pod;第二个选择器再增加生产环境条件,只剩 web-a。
使用集合选择器和动态标签
等值选择器适合精确匹配,集合式选择器适合表达多个候选值或排除条件。例如,env in (prod,test) 表示环境属于给定集合,tier notin (backend) 表示层级不属于后端。
set -euo pipefail
# 集合式条件用于包含多个值或排除某一组值
printf 'set-selector:\n'
kubectl get pods -n label-demo -l 'env in (prod,test),tier notin (backend)' -o name
# 修改标签后,再次观察选择结果
kubectl label pod web-b -n label-demo env=prod --overwrite
printf 'after-relabel:\n'
kubectl get pods -n label-demo -l 'env=prod,tier=frontend' -o name预期输出如下。
set-selector:
pod/web-a
pod/web-b
pod/web-b labeled
after-relabel:
pod/web-a
pod/web-b修改 Label 后,资源会立即进入或退出相应选择器的结果集。控制器和 Service 也会据此重新计算目标对象,因此不要随意改动承载路由、归属或控制关系的标签。
写入注解并清理环境
注解可以独立更新,不会改变任何 Label 选择结果。下面写入评审团队信息,并通过 JSONPath 读取带点号和斜杠的注解键。
set -euo pipefail
# 注解键中的点号在 JSONPath 中需要转义
kubectl annotate pod web-a -n label-demo training.example.com/reviewer=team-a --overwrite
kubectl get pod web-a -n label-demo -o jsonpath='{.metadata.annotations.training\.example\.com/reviewer}{"\n"}'
kubectl delete -f labeled-pods.yaml
kubectl delete namespace label-demo预期输出如下。
pod/web-a annotated
team-a
pod "web-a" deleted
pod "web-b" deleted
pod "api" deleted
namespace "label-demo" deleted常见问题包括 Label 拼写不一致、选择器条件过多导致结果为空,以及 Deployment 的 spec.selector.matchLabels 与 Pod 模板标签不一致。排查时先用 kubectl get <RESOURCE> --show-labels 查看真实标签,再逐步减少选择条件,确认是哪一个条件没有匹配。