K8s新手系列之Label标签和Label选择器

时间：2025-05-04 12:00:14

概述

官网：https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/

在K8s中，Label（标签） 是用于标识和组织集群资源（如Pod、Service、Deployment、Node等）的核心机制，其主要作用就是在各种资源上添加表示，用来对它们进行区分和选择。

Label的特点

  • 一个Label会以key/value键值对的形式附加到各种对象上，如Node、Pod、Service等等
  • 一个资源对象可以定义任意数量的Label ，同一个Label也可以被添加到任意数量的资源对象上去
  • Label通常在资源对象定义时确定，当然也可以在对象创建后动态添加或者删除

Label的定义规则

Key的定义规则

  • kubernetes.io/ 和 k8s.io/ 前缀是为 Kubernetes 核心组件保留的。
  • 格式：[前缀/]名称
  • 前缀（可选）：DNS子域格式（如 k8s.example.com/），不超过253字符。
  • 名称：不超过63字符，允许字母、数字、-、_、.，且需以字母或数字开头和结尾

Value的定义规则

  • 必须为 63 个字符或更少（可以为空）
  • 除非标签值为空，必须以字母数字字符（[a-z0-9A-Z]）开头和结尾
  • 包含破折号（-）、下划线（_）、点（.）和字母或数字

Label的操作

给资源添加Label

方式一：在资源清单中指定

可以在资源文件中的metadata.labels中指定标签。以定义Pod为例：

# 创建Pod
[root@master01 ~/label]# cat pod-label.yaml
apiVersion: v1
kind: Pod
metadata:
  name: pod-label
  # 添加label标签，标签以key: value的形式定义
  labels:
    app: nginx
spec:
  containers:
  - name: nginx-container
    image: nginx
[root@master01 ~/label]# kubectl apply -f pod-label.yaml
pod/pod-label created

# 验证是否定义成功
[root@master01 ~/label]# kubectl get pod pod-label --show-labels
NAME        READY   STATUS    RESTARTS   AGE   LABELS
pod-label   1/1     Running   0          49s   app=nginx

方式二：直接在已存在的资源上添加Label

语法：

kubectl label pods <pod-name> <labelKey=value>

示例：在上述创建Pod中添加一个新的label

# 添加label
[root@master01 ~/label]# kubectl label pods pod-label env=dev
pod/pod-label labeled
# 验证是否添加成功
[root@master01 ~/label]# kubectl get pod pod-label --show-labels
NAME        READY   STATUS    RESTARTS   AGE     LABELS
pod-label   1/1     Running   0          4m10s   app=nginx,env=dev

修改资源中指定的LabelValue

Label的Key无法进行修改，只能进行删除，或者添加一个新的Key，将原来的Key进行删除，形成修改的假象，这里我们主要讲解修改Label的Value

语法：

kubectl label pods <pod-name> <labelKey=value> --overwrite

示例：将上述Pod的env的value修改为prod

# 修改Label
[root@master01 ~/label]# kubectl label pods pod-label env=prod --overwrite
pod/pod-label labeled
# 验证是否修改成功
[root@master01 ~/label]# kubectl get pod pod-label --show-labels
NAME        READY   STATUS    RESTARTS   AGE   LABELS
pod-label   1/1     Running   0          12m   app=nginx,env=prod

查看资源中的Label

示例：

# 查看指定资源的Label
[root@master01 ~/label]# kubectl get pod --show-labels
NAME                READY   STATUS    RESTARTS   AGE   LABELS
pod-label           1/1     Running   0          13m   app=nginx,env=prod
static-web-node02   1/1     Running   0          18m   role=myrole

# 查看指定资源的Label列
[root@master01 ~/label]# kubectl get pod -L env,app
NAME                READY   STATUS    RESTARTS   AGE   ENV    APP
pod-label           1/1     Running   0          13m   prod   nginx
static-web-node02   1/1     Running   0          18m

删除资源中的Label

语法：

# 注意，labelKey后有一个"-"减号
kubectl label pods <pod-name> <labelKey>-

示例：删除上述Pod中的env的label

# 删除Label
[root@master01 ~/label]# kubectl label pod pod-label env-
pod/pod-label unlabeled

# 验证是否删除成功
[root@master01 ~/label]# kubectl get pod pod-label --show-labels
NAME        READY   STATUS    RESTARTS   AGE   LABELS
pod-label   1/1     Running   0          18m   app=nginx

Label选择器

官网文档：https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/#label-selectors

在Kubernetes中，Label选择器（Label Selector） 是用于根据标签（Label）筛选和操作资源的核心机制。
Kubernetes中支持两种类型的Label选择器

等式选择器

通过精确匹配标签的键和值来筛选资源，支持以下操作符：

  • =或者==：匹配key等于指定value的资源
# 选择所有包含 `env=prod` 标签的Pod
kubectl get pods -l env=prod
  • !=：匹配键值不等于指定值的资源
# 选择所有不包含 `tier=frontend` 标签的Pod
kubectl get pods -l tier!=frontend

集合选择器

通过集合操作符（如 in、notin、exists）灵活筛选资源，支持更复杂的条件。

  • in：指定key的value在指定的集合中
# 选择 `env` 是 `prod` 或 `staging` 的Pod
kubectl get pods -l "env in (prod, staging)"
  • notin: key的value不在指定集合中
kubectl get pods -l "env notin (frontend, backend)"
  • exists：key必须存在（不关心value）
# 选择存在env这个key的Pod
kubectl get pods -l "env,app"
  • doesnotexist：key必须不存在
# 选择不包含 `tier`、`test` 标签的Pod，
# 注意！！！这里需要使用单引号，使用双引号可能导致bash不解析
kubectl get pods -l '!tier,!test'

通过Label操作K8s的资源

通过Label查看指定的资源

语法：

kubectl get <resource-type> -l <label-operation> -n <namespace>

示例：

# 查看label为app=nginx的Pod
[root@master01 ~/label]# kubectl get pod -l "app=nginx"
NAME        READY   STATUS    RESTARTS   AGE
pod-label   1/1     Running   0          37m

# 查看calico-system名称空间下指定的Label存在的Pod
[root@master01 ~/label]# kubectl get po -l "app.kubernetes.io/name" -n calico-system
NAME                                       READY   STATUS    RESTARTS        AGE
calico-kube-controllers-585c6db9c7-9wm4p   1/1     Running   1 (6d22h ago)   6d23h
calico-node-64sq8                          1/1     Running   0               22h
calico-node-kgkmk                          1/1     Running   0               22h
calico-node-vn47d                          1/1     Running   0               22h
calico-typha-666d79c78b-65szp              1/1     Running   1 (6d22h ago)   6d23h
calico-typha-666d79c78b-n9mjq              1/1     Running   1 (6d22h ago)   6d23h
csi-node-driver-92w48                      2/2     Running   4 (6d22h ago)   6d23h
csi-node-driver-96tfv                      2/2     Running   2 (6d22h ago)   6d23h
csi-node-driver-wbf7v                      2/2     Running   2 (6d22h ago)   6d23h

通过Label删除资源

语法：

kubectl delete <resource-type> -l <label> -n <namespace>

示例：

# 通过label删除Pod
[root@master01 ~/label]# kubectl delete po -l "app=nginx"
pod "pod-label" deleted

# 验证是否删除成功
[root@master01 ~/label]# kubectl get po pod-label
Error from server (NotFound): pods "pod-label" not found

资源文件中使用选择器

示例：Deployment中使用

在Deployment中，spec.selector 用于选择目标Pod。常用 matchLabels 或 matchExpressions：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx   # 精确匹配标签 app=nginx
    matchExpressions:  # 集合选择器（可选）
      - {key: env, operator: In, values: [prod, staging]}
  template:
    metadata:
      labels:
        app: nginx
        env: prod
    # ... Pod配置

示例：Service中使用

Service通过 spec.selector 选择Pod：

apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx   # 选择所有包含 app=nginx 标签的Pod
  ports:
    - protocol: TCP
      port: 80
      targetPort: 9376

Label及Label选择器的使用场景

  • 批量操作资源：通过标签选择器批量操作符合条件的资源
  • 服务发现：Service通过选择器关联Pod，实现动态流量路由
  • 多维度分组：按照业务、环境、层级等多维度管理资源
  • 通过标签区分新旧版本Pod，逐步切换流量

相关文章