imicola CRD,CR,Scheme
CRD,CR,Scheme

CRD,CR,Scheme

616 字 · 约 2 分钟

CRD(CustomResourceDefinition): 主要在于 Definition ,它告诉 k8s API Server 我们的资源中有一种叫 MaintenancePlan,其 API 分支,版本,字段结构都是什么。CRD 必须通过 kubectl apply -f k8s/maintenance-crd.yaml 来安装到集群中,可以理解为一份表单模板

CR(CustomResource): CRD 中 D 的就是这个 CR,是某一份具体的申请实例。在集群中创建一份 CR 只相当于填写好一份表单,集群业务不会自动发生变化,必须有一个正在运行且具有充足权限的控制器进程去监听和协调它

Scheme(Go 运行时的类型注册表): k8s的很多状态资源都是通过 JSON 格式保存或传递的,Scheme 规定了 go 代码中如何将 JSON 字节流转化为 Go 语言中的具体结构体 &MaintenancePlan{}

k8s 中的标识符

标识字段 控制器中的作用
metadata.name / namespace 定位资源的请求 Key,作为 Reconcile 队列的索引。
metadata.uid 唯一身份证。整个生命周期全局唯一。本控制器用来绑定 Plan、Node、Deployment 以及待驱逐 Pod 的单次生命周期。
metadata.generation Spec 期望代次。每当用户修改了 spec,API Server 会自动递增它。控制器把处理完的代次记录在 status.observedGeneration。
metadata.resourceVersion 并发控制版本(etcd 事务版本)。Update 操作如果携带了旧版本号,API Server 会直接返回 409 Conflict。

[!spce与status的契约]+

  • spec 表达的是用户的期望目标与授权边界
  • status 表达的是控制器当前观察到的事实与推进阶段

写 status 不会改变物理世界的运行状态,即我们在 status 中将 phase 改成了 WorkloadEvacuated 不意味真实的旧报告已经退出,新 Pod 已经健康运行,status 只是一份事后报告,和真实集群状态解耦

保守契约

在定义 play_type.go 中,控制器在进入疏散流程的第一时刻中,就会将 plan.Generation 和 fact.TargetUID 保存在 status.evictionProgress 中:

type EvictionProgress struct {
    PlanGeneration int64         `json:"planGeneration"`
    DeploymentUID  string        `json:"deploymentUID"`
    StartedAt      metav1.Time   `json:"startedAt"`
    Deadline       metav1.Time   `json:"deadline"`
    ActivePod      *ActivePodRef `json:"activePod,omitempty"`
    NextActionAt   *metav1.Time  `json:"nextActionAt,omitempty"`
}
go

这样在后续协调中,如果协调器发现了用户修改了 Plan 的 spec,或者说目标的 Deployment 被人删除重新创建,那么控制器就会立刻 中止自动推进 ,将 Phase 置于 Blocked 并交由人工排查,我们不能将上一代意图或旧对象的处理进度,悄悄套用到新对象身上