6.从 Go 结构体到 etcd 持久化
在真实的 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 事件风暴