容器与云原生 / 系统课时

标签、选择器与注解

标签、选择器与注解

本课通过三个可运行的 Pod 演示 Label、Selector 和 Annotation 的分工。你将为资源添加分类信息,用选择器动态筛选对象,再写入不参与筛选的扩展描述,最终形成可供控制器、查询命令和自动化工具共同使用的元数据体系。

学习目标

  • 区分标签、选择器与注解的职责。
  • 编写等值选择器和集合式选择器。
  • 使用 kubectl 修改元数据并验证筛选结果。

三类元数据如何协作

Label 是短小、可筛选的键值对,适合表达应用、环境、层级和版本等分类维度。Selector 是匹配规则,本身不存储在被筛选对象中;Service、Deployment 和查询命令都可以使用它选择一组资源。Annotation 用于保存负责人、说明、工具状态等扩展信息,但不参与选择。

Kubernetes 标签、选择器与注解关系

对象 适合保存 是否可筛选
Label 应用名、环境、层级、发布批次 是
Selector 一组 Label 的匹配条件 用于执行筛选
Annotation 负责人、审计说明、外部工具信息 否

标签应表达稳定的分类事实,不要把长文本、时间线日志或频繁变化的大段状态放入 Label。需要扩展描述时,应改用 Annotation,并优先采用带域名前缀的键,例如 training.example.com/owner。

创建带标签和注解的资源

下面的清单创建三个长期运行的 Pod。它们都属于 shop 应用,但层级和环境不同;web-a 还带有一条负责人注解。

yaml
# 生产环境的前端 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 就绪后才继续执行筛选。

bash
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

预期输出如下。

text
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) 表示层级不属于后端。

bash
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

预期输出如下。

text
set-selector:
pod/web-a
pod/web-b
pod/web-b labeled
after-relabel:
pod/web-a
pod/web-b

修改 Label 后,资源会立即进入或退出相应选择器的结果集。控制器和 Service 也会据此重新计算目标对象,因此不要随意改动承载路由、归属或控制关系的标签。

写入注解并清理环境

注解可以独立更新,不会改变任何 Label 选择结果。下面写入评审团队信息,并通过 JSONPath 读取带点号和斜杠的注解键。

bash
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

预期输出如下。

text
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 查看真实标签,再逐步减少选择条件,确认是哪一个条件没有匹配。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

标签、选择器与注解

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通