3. 开发环境搭建：Go 语言环境配置、Kubebuilder 安装、本地集群搭建

调试 SLOperator 控制器之前，必须搭建一套完整、可复现的本地开发环境。本章涵盖三个核心环节：Go 语言环境（控制器编译与运行的基础）、Kubebuilder 工具链（脚手架与代码生成）、本地 Kubernetes 集群（控制器的运行目标）。三者缺一不可，且版本组合必须严格匹配。

3.1 Go 语言环境配置

Go 是控制器开发的核心语言。推荐使用官方多版本管理工具 go install 或 gvm 管理版本，避免系统包管理器版本滞后。

3.1.1 安装与验证

# 下载 Go 1.21.x 安装包（以 Linux amd64 为例）
wget https://go.dev/dl/go1.21.13.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.21.13.linux-amd64.tar.gz

# 配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

# 验证版本
go version
# 期望输出: go version go1.21.13 linux/amd64

3.1.2 环境变量清单

3.2 Kubebuilder 安装

Kubebuilder 是 Kubernetes Operator 的标准脚手架工具，负责生成项目骨架、CRD 定义、控制器模板和 Webhook 桩代码。SLOperator 项目使用 Kubebuilder v3 架构。

3.2.1 安装方式

# 方式一：直接下载二进制（推荐）
curl -L -o kubebuilder "https://github.com/kubernetes-sigs/kubebuilder/releases/download/v3.14.1/kubebuilder_linux_amd64"
chmod +x kubebuilder && sudo mv kubebuilder /usr/local/bin/

# 方式二：通过 go install 安装（需已配置 Go）
go install sigs.k8s.io/kubebuilder/v3/cmd/kubebuilder@v3.14.1

# 验证安装
kubebuilder version
# 期望输出: version: "v3.14.1"

3.2.2 配套工具链

Kubebuilder 依赖以下二进制工具，安装后会自动检测或提示缺失：

3.3 本地集群搭建：Kind vs Minikube

本地集群是控制器的运行目标。Kind（Kubernetes in Docker）和 Minikube 是两种主流方案，各有适用场景。SLOperator 调试推荐 Kind，因其启动快、资源占用低、与 CI 环境一致。

3.3.1 方案对比

3.3.2 Kind 集群搭建步骤

# 安装 Kind（二进制方式）
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.23.0/kind-linux-amd64
chmod +x ./kind && sudo mv ./kind /usr/local/bin/kind

# 创建集群配置文件（支持多节点与端口映射）
cat <<EOF > kind-config.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
    extraPortMappings:
      - containerPort: 30080
        hostPort: 30080
  - role: worker
  - role: worker
EOF

# 启动集群
kind create cluster --config kind-config.yaml --name slo-dev

# 验证集群状态
kubectl cluster-info --context kind-slo-dev
kubectl get nodes

3.3.3 Minikube 集群搭建步骤（备选）

# 安装 Minikube
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 启动集群（指定驱动与 Kubernetes 版本）
minikube start --driver=docker --kubernetes-version=v1.28.0 --cpus=4 --memory=8g

# 启用必要插件
minikube addons enable metrics-server
minikube addons enable ingress

# 验证
kubectl get nodes
minikube status

3.4 环境验证与工具链检查清单

完成上述安装后，执行以下命令验证整个工具链是否就绪：

# 1. Go 编译测试
cat <<EOF > /tmp/hello.go
package main
import "fmt"
func main() { fmt.Println("Go OK") }
EOF
go run /tmp/hello.go

# 2. Kubebuilder 初始化测试（空项目）
mkdir -p /tmp/test-operator && cd /tmp/test-operator
kubebuilder init --domain slo.example.com --repo github.com/example/slo-operator

# 3. 集群连通性测试
kubectl get ns
kubectl create deploy nginx --image=nginx:alpine
kubectl delete deploy nginx

# 4. 清理测试项目
cd /tmp && rm -rf test-operator

如果以上四步全部通过，说明开发环境已完全就绪，可以进入下一章的项目初始化与 CRD 设计。

3.5 常见问题与快速修复