2. Operator SDK 入门：安装、项目初始化与项目结构解析

Operator SDK 是构建 Kubernetes Operator 的官方脚手架工具，它封装了 controller-runtime 和 client-go 的底层细节，让开发者能够专注于业务逻辑而非样板代码。本节将带你完成 SDK 的安装、第一个项目的初始化，并深入解析生成的项目骨架。

2.1 安装 Operator SDK

Operator SDK 支持 Linux、macOS 和 Windows（WSL2）环境。推荐使用 Homebrew 或直接下载预编译二进制进行安装。

2.2 项目初始化

使用 operator-sdk init 命令创建项目骨架。以下是一个典型的初始化流程：

1. 创建项目目录并进入：mkdir memcached-operator && cd memcached-operator
2. 初始化 Go Module 项目：

   operator-sdk init \
     --domain=example.com \
     --repo=github.com/example/memcached-operator \
     --language=go

3. 创建 API 和 Controller：

   operator-sdk create api \
     --group=cache \
     --version=v1alpha1 \
     --kind=Memcached \
     --resource=true \
     --controller=true

2.3 项目结构深度解析

初始化完成后，项目目录结构如下。每个文件/目录都有明确的职责：

memcached-operator/
├── .github/              # GitHub Actions CI/CD 配置
├── config/               # Kubernetes 资源清单（RBAC、CRD、Webhook 等）
│   ├── crd/              # 生成的 CRD YAML 文件
│   ├── rbac/             # ServiceAccount、Role、RoleBinding
│   ├── manager/          # Operator Deployment 和 Service
│   └── samples/          # CR 示例 YAML
├── controllers/          # 控制器逻辑（Reconcile 循环）
│   └── memcached_controller.go
├── api/                  # API 类型定义（CRD 的 Go 结构体）
│   └── v1alpha1/
│       ├── memcached_types.go
│       └── zz_generated.deepcopy.go
├── internal/             # 内部工具包（可选）
├── main.go               # 入口文件，注册 Scheme 和 Controller
├── go.mod / go.sum       # Go 依赖管理
├── Makefile              # 构建、测试、部署命令
└── PROJECT               # Operator SDK 元数据文件

2.4 核心文件职责速查表

2.5 Reconcile 循环的工作流程

控制器核心是 Reconcile 方法，它遵循“输入-调谐-输出”的闭环模式：

1. 接收事件：当 CR 被创建、更新或删除时，controller-runtime 将事件入队。
2. 获取当前状态：通过 r.Get(ctx, req.NamespacedName, &memcached) 读取 CR 实例。
3. 对比期望状态：检查当前集群资源（如 Deployment、Service）是否与 CR Spec 一致。
4. 执行调谐动作：创建/更新/删除子资源，使集群状态趋近期望状态。
5. 更新状态：通过 r.Status().Update(ctx, &memcached) 回写 Status 字段。
6. 返回结果：返回 ctrl.Result{Requeue: false} 或 ctrl.Result{RequeueAfter: 30 * time.Second}。

2.6 常见问题与避坑指南