目录
Label(标签)是Kubernetes系统中一个比较重要的概念,给某个资源对象(Node、Pod、Service等)定义一个Label,就相当于给它打了一个标签,然后可以通过Label Selector(标签选择器)查询和筛选拥有某些Label的资源对象,Kubernetes通过label对资源进行分区和管理。
Label的特点:
我们可以通过给指定的资源对象捆绑一个或多个不同的Label来实现多维度的资源分组管理功能,以便灵活、方便地进行资源分配、调度、配置、部署等管理工作。
示例如下:这是一个有 environment: production 和 app: nginx 标签的 Pod 配置文件。
- apiVersion: v1
- kind: Pod
- metadata:
- name: label-demo
- labels: # 定义标签集合
- environment: production # 使用键值对方式定义
- app: nginx
- spec:
- containers:
- - name: nginx
- image: nginx:1.14.2
- ports:
- - containerPort: 80
Label标签定义完毕之后,还要考虑到标签的选择,这就要使用到Label Selector(标签选择器),即:
API 目前支持两种类型的选择算符:基于等值的和基于集合的。
基于等值或基于不等值的需求允许按标签键和值进行过滤。 匹配对象必须满足所有指定的标签约束,尽管它们也可能具有其他标签。 可接受的运算符有 =、== 和 != 三种。 前两个表示相等(并且是同义词),而后者表示不相等。例如:
基于集合的标签需求允许你通过一组值来过滤键。 支持三种操作符:in、notin 和 exists(只可以用在键标识符上)。例如:
标签的选择条件可以使用多个,此时将多个Label Selector进行组合,使用逗号","进行分隔即可。例如app=nginx,environment!=prod、release in (stable, beta),app=nginx等等。
复杂查询下Selector的示例:
- selector:
- matchLabels: # 由 {key,value} 对组成的映射
- app: nginx
- matchExpressions: # Pod 选择算符需求的列表
- # 可以使用的操作包括In、NotIn、Exists、DoesNotExist
- - { key: tier , operator: In , values: [frontend]}
- - { key: environment, operator: NotIn, values: [dev]}
以nginx Pod为例,Label被定义在其metadata中,如下图:
然后我们就可以在Service、RC等管理对象中通过Label Selector(标签选择器)设置需要关联Pod的Label,如下图:
kubectl get xxx 命令默认不会列出任何标签,使用 --show-labels 选项来查看。例如:
- $ kubectl get pod
- NAME READY STATUS RESTARTS AGE
- nginx-748c667d99-6d5s9 1/1 Running 0 35m
-
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-6d5s9 1/1 Running 0 35m app=nginx,pod-template-hash=748c667d99
-
- $ kubectl get svc
- NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
- kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 7d8h
- nginx NodePort 10.103.144.31 <none> 80:32327/TCP 34m
-
- $ kubectl get svc --show-labels
- NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE LABELS
- kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 7d8h component=apiserver,provider=kubernetes
- nginx NodePort 10.103.144.31 <none> 80:32327/TCP 35m app=nginx
查看匹配标签条件的pod:
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-6d5s9 1/1 Running 0 41m app=nginx,pod-template-hash=748c667d99
-
- $ kubectl get pod -l app=nginx
- NAME READY STATUS RESTARTS AGE
- nginx-748c667d99-6d5s9 1/1 Running 0 42m
-
- $ kubectl get pod -l app=nginx1
- No resources found in default namespace.
查看匹配标签key的pod:
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-6d5s9 1/1 Running 0 43m app=nginx,pod-template-hash=748c667d99
-
- $ kubectl get pod -L app
- NAME READY STATUS RESTARTS AGE APP
- nginx-748c667d99-6d5s9 1/1 Running 0 43m nginx
-
- $ kubectl get pod -L pod-template-hash
- NAME READY STATUS RESTARTS AGE POD-TEMPLATE-HASH
- nginx-748c667d99-6d5s9 1/1 Running 0 44m 748c667d99
多个匹配条件之间使用逗号分开,多个条件之间是“and”关系。例如:
- # 选择release为stable或者beta的pod
- kubectl get pod -l 'release in (stable, beta)' --show-labels
-
- # 选择release为stable或者beta但不包括env=test的pod
- kubectl get pod -l env!=test,'release in (stable, beta)' --show-labels
给名为nginx 的pod添加Label:environment=dev
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-6d5s9 1/1 Running 0 45m app=nginx,pod-template-hash=748c667d99
-
- $ kubectl label pod nginx-748c667d99-6d5s9 environment=dev
- pod/nginx-748c667d99-6d5s9 labeled
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-6d5s9 1/1 Running 0 46m app=nginx,environment=dev,pod-template-hash=748c667d99
把名为nginx 的pod修改Label 为 environment=test,且覆盖现有的value。
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-2trsf 1/1 Running 0 60s app=nginx,environment=dev,pod-template-hash=748c667d99
-
- #使用--overwrite覆盖
- $ kubectl label pod nginx-748c667d99-2trsf environment=test --overwrite
- pod/nginx-748c667d99-2trsf labeled
-
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-2trsf 1/1 Running 0 2m12s app=nginx,environment=test,pod-template-hash=748c667d99
注意,如果更新的时候标签不存在怎么处理呢?答案是会创建一个新的标签。例如:
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-q2j2r 1/1 Running 0 44s app=nginx,env=test,pod-template-hash=748c667d99
-
- # 更新一个不存在的标签release=stable,那么k8s将会创建新的标签,自动添加上去
- $ kubectl label pod nginx-748c667d99-q2j2r release=stable --overwrite
- pod/nginx-748c667d99-q2j2r labeled
-
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-q2j2r 1/1 Running 0 105s app=nginx,env=test,pod-template-hash=748c667d99,release=stable
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-2trsf 1/1 Running 0 2m12s app=nginx,environment=test,pod-template-hash=748c667d99
-
- #标签名后面加个“-”就代表要删除该标签
- $ kubectl label pod nginx-748c667d99-2trsf environment-
- pod/nginx-748c667d99-2trsf unlabeled
-
- $ kubectl get pod --show-labels
- NAME READY STATUS RESTARTS AGE LABELS
- nginx-748c667d99-2trsf 1/1 Running 0 5m6s app=nginx,pod-template-hash=748c667d99
除了给Pod添加Label之外,Service、Node等对象也是可以添加标签的,例如某个应用需要运行在一个或者多个固定的节点上,我们就可以给Node节点添加特定的Label,这样k8s调度的时候,只会将Pod调度到具有特定Label的节点上。
一些常用的Label示例如下:
有一些常用标签的例子;你可以任意制定自己的约定。 请记住,标签的 Key 对于给定对象必须是唯一的。
Label Selector在Kubernetes中的重要使用场景如下。