2. 开发环境准备：Go 语言环境安装、Kubebuilder 与 Operator SDK 安装、Minikube/Kind 集群搭建

本章将搭建完整的 Operator 开发环境，涵盖 Go 语言运行时、Kubebuilder/Operator SDK 工具链以及本地 Kubernetes 集群。环境一致性是避免“在我机器上能跑”问题的关键，请严格按版本对应关系安装。

2.1 环境版本对应关系

Operator SDK 与 Kubebuilder、Go、Kubernetes 集群之间存在严格的版本兼容性。以下为当前稳定推荐组合：

2.2 Go 语言环境安装

Operator 开发依赖 Go 的静态编译与代码生成能力。推荐使用官方二进制安装，避免包管理器版本滞后。

2.2.1 Linux / macOS 安装步骤

1. 下载 Go 二进制包：wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz
2. 解压到 /usr/local：sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz
3. 配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）：

export GOPATH=$HOME/go
export GOROOT=/usr/local/go
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

4. 验证安装：go version 应输出 go version go1.22.5 linux/amd64

2.2.2 Go 环境关键配置

2.3 Kubebuilder 与 Operator SDK 安装

Kubebuilder 是核心脚手架工具，Operator SDK 在其之上提供额外的测试与部署命令。两者安装路径不同，但最终 CLI 可共存。

2.3.1 安装 Kubebuilder

# 下载 Kubebuilder 二进制
curl -L -o kubebuilder "https://github.com/kubernetes-sigs/kubebuilder/releases/download/v4.3.0/kubebuilder_linux_amd64"

# 赋予执行权限并移动到 PATH
chmod +x kubebuilder
sudo mv kubebuilder /usr/local/bin/

# 验证
kubebuilder version

2.3.2 安装 Operator SDK

# 使用 Homebrew（macOS）
brew install operator-sdk

# 或 Linux 手动安装
export ARCH=$(case $(uname -m) in x86_64) echo -n amd64 ;; aarch64) echo -n arm64 ;; esac)
export OS=$(uname | awk '{print tolower($0)}')
curl -LO "https://github.com/operator-framework/operator-sdk/releases/download/v1.37.0/operator-sdk_${OS}_${ARCH}"
chmod +x operator-sdk_${OS}_${ARCH}
sudo mv operator-sdk_${OS}_${ARCH} /usr/local/bin/operator-sdk

# 验证
operator-sdk version

2.3.3 工具链关系

下图展示了 Operator SDK、Kubebuilder 与底层库的调用层级：

2.4 Minikube / Kind 集群搭建

本地集群是 Operator 调试的核心环境。Minikube 适合单节点快速验证，Kind 适合多节点与 CI 流水线。建议两者都安装，按场景切换。

2.4.1 Minikube 安装与启动

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

# 启动集群（指定驱动与资源）
minikube start --driver=docker --cpus=4 --memory=8192 --kubernetes-version=v1.30.0

# 验证
kubectl get nodes
minikube status

2.4.2 Kind 安装与集群创建

# 安装 Kind
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.24.0/kind-linux-amd64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

# 创建多节点集群配置文件 kind-config.yaml
cat <<EOF > kind-config.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
  - role: worker
  - role: worker
EOF

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

# 验证
kubectl cluster-info --context kind-operator-dev

2.4.3 集群选择对比

2.5 环境验证清单

完成安装后，执行以下命令确认所有组件就绪：

# 1. Go 版本
go version

# 2. Kubebuilder 版本
kubebuilder version

# 3. Operator SDK 版本
operator-sdk version

# 4. kubectl 版本与集群连通性
kubectl version --client
kubectl cluster-info

# 5. 集群节点状态
kubectl get nodes

# 6. 测试 Operator SDK 项目初始化（可选）
mkdir -p ~/operator-test && cd ~/operator-test
operator-sdk init --domain example.com --repo github.com/example/memcached-operator
operator-sdk create api --group cache --version v1alpha1 --kind Memcached --resource --controller
make generate manifests
echo "环境验证通过"

2.6 开发环境架构总览

以下 SVG 图展示了开发机、本地集群与 Operator 进程之间的通信路径：