imicola 6.从 Go 结构体到 etcd 持久化
6.从 Go 结构体到 etcd 持久化

6.从 Go 结构体到 etcd 持久化

384 字 · 约 1 分钟

在真实的 k8s 体系中,一个字段要真正安全的落入 etcd 并且在重启后能被准确读出,必须经历下述环节:

[Go 结构体] ──(JSON Tag)──► [Scheme 序列化] ──(HTTP POST)──► [API Server Schema 校验与裁剪]
     ▲                                                                   │
     │                                                                   ▼
[内存对象状态还原] ◄──(DeepCopy/反序列化)── [本地缓存/etcd 读取] ◄───── [etcd 真正落盘]

这其中有几点是需要注意的:

  • Go 字段与类型定义: 必须使用指针类型 *metav1.Time,这是因为,如果使用普通类型,零值会被序列化为一个无意义的时间戳,而指针类型的 nil 则可以表达 “当前没有冷却约束 / 历史旧版本 CR 没有该字段” 从而实现向前兼容
  • JSON Tag 契约: 需要明确指定 json:"nextActionAt,omitempty" 以确保序列化时的字段大小写与 CRD 定义的完全一致
  • CRD OpenAPI v3 Schema 声明: 在 k8s/maintenance-crd.yaml 必须明确加入 nextActionAt 的字段声明,如果遗漏则会被 API Server 静默丢弃
  • 深拷贝与浅拷贝: 在协调器比对状态变化的时候,不能简单使用 before := plan.Status ,因为 Status 内部包含指针,浅拷贝会复制指针地址,当后续修改了 NextActionAt 后,由于 before 中的指针指向同一个地址,从而也会变成新值
  • 无变化不写 statusEqual: 在 writeDrainStatus 中,每次准备写 status 前,都会比对 statusEqual(before, plan.Status)。只有当状态、原因或冷却时刻真正发生变化时才调用 API。这不仅是为了降低 API Server 的写入负载,更是为了防止无意义的 Update 再次激起我们前面分析过的 Watch 事件风暴