使用 Kubebuilder 开发自定义 Operator
Kubernetes 的 Operator 模式将运维知识编码为软件,让我们可以像管理原生资源一样管理复杂的有状态应用。Kubebuilder 作为官方推荐的 Operator 开发框架,提供了脚手架生成、CRD 管理和 Controller 运行时等完整工具链。
首先,我们使用 Kubebuilder 初始化项目并创建 API:
# 初始化项目
kubebuilder init --domain my.domain --repo my.domain/guestbook
# 创建 API(包含 CRD 和 Controller)
kubebuilder create api --group webapp --version v1 --kind Guestbook
生成的 CRD 定义在 api/v1/guestbook_types.go 中,我们需要定义资源的期望状态(Spec)和实际状态(Status):
// GuestbookSpec 定义期望状态
type GuestbookSpec struct {
// 前端副本数
FrontendReplicas int32 `json:"frontendReplicas"`
// Redis 主从配置
Redis RedisSpec `json:"redis"`
}
// GuestbookStatus 定义观察到的状态
type GuestbookStatus struct {
AvailableReplicas int32 `json:"availableReplicas"`
Conditions []metav1.Condition `json:"conditions,omitempty"`
}
Controller 的核心是 Reconcile 循环,它不断将实际状态调谐到期望状态。在 Reconcile 方法中,我们需要处理资源的创建、更新和删除,并确保子资源(Deployment、Service 等)与 CRD 的声明一致。这种声明式的设计让 Operator 具备了自愈能力——当某个 Pod 异常退出时,Controller 会自动重建。
最后,通过 kubebuilder generate crd 生成 CRD 清单,kubebuilder generate webhook 添加准入控制。部署时,将 Manager 以 Deployment 形式运行在集群中,RBAC 权限通过 kubebuilder 注解自动生成。