3.22 Kubebuilder实战进阶：控制器测试、Webhook、多版本CRD完整实现

引言

Kubebuilder提供了丰富的功能来构建生产级的Operator。本文将深入介绍控制器测试、Webhook、多版本CRD等高级功能，帮助你构建完整的Operator解决方案。

一、控制器测试

1.1 单元测试

func TestMyAppReconciler(t *testing.T) {
    tests := []struct {
        name string
        // ...
    }{
        // ...
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            // 测试逻辑
        })
    }
}

1.2 集成测试

func TestMyAppIntegration(t *testing.T) {
    env := &envtest.Environment{}
    cfg, err := env.Start()
    // ...
}

二、Webhook

2.1 创建Webhook

kubebuilder create webhook --group apps --version v1 --kind MyApp --defaulting --programmatic-validation

2.2 验证Webhook

func (r *MyApp) ValidateCreate() error {
    if r.Spec.Replicas < 1 {
        return fmt.Errorf("replicas must be >= 1")
    }
    return nil
}

2.3 默认值Webhook

func (r *MyApp) Default() {
    if r.Spec.Port == 0 {
        r.Spec.Port = 8080
    }
}

三、多版本CRD

3.1 创建新版本

kubebuilder create api --group apps --version v2 --kind MyApp

3.2 版本转换

func (r *MyApp) ConvertTo(dstRaw conversion.Hub) error {
    dst := dstRaw.(*v2.MyApp)
    // 转换逻辑
    return nil
}

func (r *MyApp) ConvertFrom(srcRaw conversion.Hub) error {
    src := srcRaw.(*v2.MyApp)
    // 转换逻辑
    return nil
}

四、实战案例

4.1 完整Operator

// 完整的Operator实现
// 包括：CRD、控制器、Webhook、测试

五、部署Operator

5.1 构建镜像

make docker-build docker-push IMG=registry.example.com/my-operator:v1.0.0

5.2 部署

make deploy IMG=registry.example.com/my-operator:v1.0.0

总结

通过本文，你学会了：

1. ✅ 控制器测试：单元测试、集成测试
2. ✅ Webhook：验证、默认值
3. ✅ 多版本CRD：版本管理、转换
4. ✅ 部署Operator：构建、部署

下一步学习

• 3.23 Helm包管理实战
• 3.24 Helm Chart开发实战

思考题

1. 如何实现Webhook的验证逻辑？
2. 多版本CRD如何实现版本转换？
3. 如何测试Operator的完整功能？

---

提示：掌握Kubebuilder高级功能可以构建生产级Operator。下一节我们将学习Helm。