Object 管理

概述

参考：
官方文档，概念-概述-使用 Kubernetes 对象-Kubernetes 对象管理
官方文档，任务-管理 Kubernetes 对象
公众号-k8s 技术圈，理解 K8s 中的 Client-Side Apply 和 Server-Side Apply
原文：掘金

使用 kubectl 等是传统的 Client-Side Apply(简称 CSA)，添加 –server-side 标志后，为 Server-Side Apply(简称 SSA)。

如果你经常与 kubectl 打交道，那相信你一定见过 kubectl.kubernetes.io/last-applied-configuration annotation，以及那神烦的 managedFields，像这样：

$ kubectl get pods hello -oyaml
apiVersion: v1
kind: Pod
metadata:
  annotations:
    kubectl.kubernetes.io/last-applied-configuration: |
      {"apiVersion":"v1","kind":"Pod","metadata":{"annotations":{},"creationTimestamp":null,"labels":{"run":"hello"},"name":"hello","namespace":"default"},"spec":{"containers":[{"image":"nginx","name":"hello","resources":{}}],"dnsPolicy":"ClusterFirst","restartPolicy":"Always"},"status":{}}      
  creationTimestamp: "2022-05-28T07:28:51Z"
  labels:
    run: hello
  managedFields:
  - apiVersion: v1
    fieldsType: FieldsV1
    fieldsV1:
      f:metadata:
        f:annotations:
          .: {}
          f:kubectl.kubernetes.io/last-applied-configuration: {}
        f:labels:
          .: {}
          f:run: {}
....
    manager: kubectl
    operation: Update
    time: "2022-05-28T07:28:51Z"
....

由这两个字段，引出本文的两位主角，Client-Side Apply（以下简称CSA）和 Server-Side Apply（以下简称SSA）

kubectl.kubernetes.io/last-applied-configuration 是使用 kubectl apply 进行 Client-Side Apply 时，由 kubectl 自行填充的。
managedFields 则是由 kubectl apply 的增强功能—— Server-Side Apply 的引入而添加。

Client-Side Apply(客户端应用)

CSA 是 kubectl apply 早期(v1.14 版本之前)唯一的对象管理手段。

需要特别指出的是，kubectl apply 声明的仅仅是它关心的字段的状态，而不是整个对象的真实状态。apply 表达的意思是：“我”管理的字段应该和我 apply 的配置文件一致(但我不关心其他字段)。

什么是“我”管理的字段，什么又是其他的字段呢？举个例子，当我们希望使用 HPA 管理应用副本数时，Kubernetes 推荐的做法是在 apply 的配置文中不指定具体 replicas 副本数。首次部署时，K8S 会将 replicas 值设置为默认 1，随后由 HPA 控制器扩容到合适的副本数。

apiVersion: apps/v1
kind: Deployment
metadata:
  creationTimestamp: null
  labels:
    app: nginx
  name: nginx
spec:
  # replicas: 1 不要设置replicas
  selector:
    matchLabels:
      app: nginx
  strategy: {}
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: nginx
    spec:
      containers:
        - image: nginx:latest
          name: nginx
          resources: {}

当升级应用时（修改镜像版本），修改配置文件中的 image 字段，再次执行 kubectl apply。此时 kubectl apply 只会影响镜像版本(因为他是“我”管理的字段)，而不会影响 HPA 控制器设置的副本数。在这个例子中，replicas 字段不是 kubectl apply 管理的字段，因此更新镜像时不会被删除，避免了每次应用升级时，副本数都会被重置。

在上述例子中，为了能识别出 replicas 不是 kubectl 管理的字段，kubectl 需要一个标识，用来追踪对象中哪些字段是由 kubectl apply 管理的，而这个标识就是 last-applied-configuration。该 annotation 是在 kubectl apply 时，由 kubectl 客户端自行填充——每次执行 kubectl apply 时（未启用 SSA），kubectl 会将本次 apply 的配置文件全量的记录在 last-applied-configurationannotation 中，用于追踪哪些字段由 kubectl apply 管理。

CSA 的工作工作机制大致如下：当 apply 一个对象，如果该对象不存在，则创建它（同时写入 last-applied-configuration）。如果对象已经存在，则 kubectl 需要根据以下三个状态：