推荐的 Labels

Table of Contents

你可以使用比 kubectl 和仪表盘更多的工具来可视化和管理 Kubernetes 对象。一组通用的标签允许工具交互操作,以所有工具都可以理解的通用方式描述对象。

除了支持工具之外,推荐的标签描述应用程序(可以被查询)。metadata 是围绕 应用 的概念组织的。Kubernetes 不是个 PaaS,并没有与应用对等的实施。 取而代之的是,应用使用非正式的,使用 metadata 来描述。定义应用的内容很松散。

注意: 这些是推荐的标签。他们使得应用程序的管理更加容易,但是核心的工具都用不到它们。

共享的标签和注解共享一个公共前缀: app.kubernetes.io 。没有前缀的标签是用户专有的。共享前缀可确保共享标签不会影响到用户自定义的标签。

1. 标签(labels)

为了重新利用这些标签,应该将它们应用于每个资源对象。

Key Description Example Type
app.kubernetes.io/name 应用名称 mysql string
app.kubernetes.io/instance 应用实例的唯一描述 mysql-abcxzy string
app.kubernetes.io/version 当前应用的版本号 5.7.21 string
app.kubernetes.io/component 架构中的组件 database string
app.kubernetes.io/part-of 应用所属更高级别的应用名称 workpress string
app.kubernetes.io/managed-by 用于管理应用程序的工具 helm string

为了说明这些标签的作用,请考虑以下的 StatefulSet 对象:

apiVersion: apps/v1
kind: StatefulSet
metadata:
  labels:
    app.kubernetes.io/name: mysql
    app.kubernetes.io/instance: wordpress-abcxzy
    app.kubernetes.io/version: "5.7.21"
    app.kubernetes.io/component: database
    app.kubernetes.io/part-of: wordpress
    app.kubernetes.io/managed-by: helm

2. 应用程序和应用程序实例

一个应用可以在 Kubernetes 集群中安装一次或者多次,并且,一些情况下还是在同一个空间中。比如,Wordpress 可以安装多次,不同的网站有不同的 Wordpress。

应用的名字和应用的实例名字是分开记录的。比如 WordPress 的 app.kubernetes.io/namewordpress ,它的实例名称是用 app.kubernetes.io/instance 表示的,值为 wordpress-abcxzy 。这样做使得应用和应用的实例是可被识别的,每个实例都必须有一个唯一的名称。

3. 范例

3.1. 一个简单的无状态服务

考虑一个简单的无状态服务通过 DeploymentService 对象部署。

Deployment 用来监视应用运行的容器。

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/name: myservice
    app.kubernetes.io/instance: myservice-abcxzy
...

Service 用来暴露应用。

apiVersion: v1
kind: Service
metadata:
  labels:
    app.kubernetes.io/name: myservice
    app.kubernetes.io/instance: myservice-abcxzy
...

3.2. 数据库的 Web 应用

考虑稍微复杂一点的应用程序:一个 Web 应用(WordPress)使用了一个数据库(MySQL),使用 Helm 安装。

WordPress 使用 Deployment 部署:

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app.kubernetes.io/name: wordpress
    app.kubernetes.io/instance: wordpress-abcxzy
    app.kubernetes.io/version: "4.9.4"
    app.kubernetes.io/managed-by: helm
    app.kubernetes.io/component: server
    app.kubernetes.io/part-of: wordpress
...

Service 暴露 WordPress:

apiVersion: v1
kind: Service
metadata:
  labels:
    app.kubernetes.io/name: wordpress
    app.kubernetes.io/instance: wordpress-abcxzy
    app.kubernetes.io/version: "4.9.4"
    app.kubernetes.io/managed-by: helm
    app.kubernetes.io/component: server
    app.kubernetes.io/part-of: wordpress
...

MySQL 使用 StatefulSet 暴露,元数据中包含它从属的应用:

apiVersion: apps/v1
kind: StatefulSet
metadata:
  labels:
    app.kubernetes.io/name: mysql
    app.kubernetes.io/instance: mysql-abcxzy
    app.kubernetes.io/version: "5.7.21"
    app.kubernetes.io/managed-by: helm
    app.kubernetes.io/component: database
    app.kubernetes.io/part-of: wordpress
...

Service 作为 WordPress 的一部分暴露:

apiVersion: v1
kind: Service
metadata:
  labels:
    app.kubernetes.io/name: mysql
    app.kubernetes.io/instance: mysql-abcxzy
    app.kubernetes.io/version: "5.7.21"
    app.kubernetes.io/managed-by: helm
    app.kubernetes.io/component: database
    app.kubernetes.io/part-of: wordpress
...

First created: 2021-02-20 16:49:05
Last updated: 2022-12-11 Sun 12:49
Power by Emacs 29.0.91 (Org mode 9.6.6)