• Label
    • 动机
    • 语法和字符集
    • Label selector
    • 示例
    • 在API object中设置label selector

    Label

    Label是附着到object上(例如Pod)的键值对。可以在创建object的时候指定,也可以在object创建后随时指定。Labels的值对系统本身并没有什么含义,只是对用户才有意义。

    1. "labels": {
    2. "key1" : "value1",
    3. "key2" : "value2"
    4. }

    Kubernetes最终将对labels最终索引和反向索引用来优化查询和watch,在UI和命令行中会对它们排序。不要在label中使用大型、非标识的结构化数据,记录这样的数据应该用annotation。

    动机

    Label能够将组织架构映射到系统架构上(就像是康威定律),这样能够更便于微服务的管理,你可以给object打上如下类型的label:

    • "release" : "stable", "release" : "canary"
    • "environment" : "dev", "environment" : "qa", "environment" : "production"
    • "tier" : "frontend", "tier" : "backend", "tier" : "cache"
    • "partition" : "customerA", "partition" : "customerB"
    • "track" : "daily", "track" : "weekly"
    • "team" : "teamA","team:" : "teamB"

    语法和字符集

    Label key的组成:

    • 不得超过63个字符
    • 可以使用前缀,使用/分隔,前缀必须是DNS子域,不得超过253个字符,系统中的自动化组件创建的label必须指定前缀,kubernetes.io/由kubernetes保留
    • 起始必须是字母(大小写都可以)或数字,中间可以有连字符、下划线和点

    Label value的组成:

    • 不得超过63个字符
    • 起始必须是字母(大小写都可以)或数字,中间可以有连字符、下划线和点

    Label selector

    Label不是唯一的,很多object可能有相同的label。

    通过label selector,客户端/用户可以指定一个object集合,通过label selector对object的集合进行操作。

    Label selector有两种类型:

    • equality-based :可以使用===!=操作符,可以使用逗号分隔多个表达式
    • set-based :可以使用innotin!操作符,另外还可以没有操作符,直接写出某个label的key,表示过滤有某个key的object而不管该key的value是何值,!表示没有该label的object

    示例

    1. $ kubectl get pods -l environment=production,tier=frontend
    2. $ kubectl get pods -l 'environment in (production),tier in (frontend)'
    3. $ kubectl get pods -l 'environment in (production, qa)'
    4. $ kubectl get pods -l 'environment,environment notin (frontend)'

    在API object中设置label selector

    servicereplicationcontroller等object中有对pod的label selector,使用方法只能使用等于操作,例如:

    1. selector:
    2. component: redis

    JobDeploymentReplicaSetDaemonSet这些object中,支持set-based的过滤,例如:

    1. selector:
    2. matchLabels:
    3. component: redis
    4. matchExpressions:
    5. - {key: tier, operator: In, values: [cache]}
    6. - {key: environment, operator: NotIn, values: [dev]}

    如Service通过label selector将同一类型的pod作为一个服务expose出来。

    label示意图

    另外在node affinity和pod affinity中的label selector的语法又有些许不同,示例如下:

    1. affinity:
    2. nodeAffinity:
    3. requiredDuringSchedulingIgnoredDuringExecution:
    4. nodeSelectorTerms:
    5. - matchExpressions:
    6. - key: kubernetes.io/e2e-az-name
    7. operator: In
    8. values:
    9. - e2e-az1
    10. - e2e-az2
    11. preferredDuringSchedulingIgnoredDuringExecution:
    12. - weight: 1
    13. preference:
    14. matchExpressions:
    15. - key: another-node-label-key
    16. operator: In
    17. values:
    18. - another-node-label-value

    详见node selection。