使用 Kubebuilder 开发自定义 Operator

使用 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 注解自动生成。