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

开发环境是 CRD Operator 调试的物理基础。本章将指导你完成三部分核心环境的搭建：Go 语言环境（编译与运行 Operator 二进制）、Kubebuilder 框架（脚手架与代码生成）、本地 Kubernetes 集群（Kind 或 Minikube，用于部署与调试）。

4.1 Go 语言环境配置

Operator 使用 Go 语言编写，依赖 Go 工具链进行编译、测试和调试。配置步骤如下：

1. 下载安装包：访问 https://go.dev/dl/，选择对应操作系统（Linux/macOS/Windows）的安装包。
2. 安装 Go：
   • Linux/macOS：解压到 /usr/local，设置 PATH。
   • Windows：运行 MSI 安装程序，默认路径 C:\Go。
3. 配置环境变量：在 ~/.bashrc 或 ~/.zshrc 中添加：

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

4. 验证安装：执行 go version，输出类似 go version go1.22.5 linux/amd64。
5. 配置 Go Proxy（国内加速）：

   go env -w GOPROXY=https://goproxy.cn,direct

4.2 Kubebuilder 安装

Kubebuilder 是 CRD Operator 开发的官方脚手架工具，负责生成项目骨架、CRD 类型定义、控制器模板和 Webhook 桩代码。

安装后执行 kubebuilder version 验证，输出应包含版本号和 Git 提交哈希。

4.3 本地 Kubernetes 集群搭建

本地集群用于运行 Operator 实例、观察 CRD 资源变化、执行调试断点。推荐两种轻量级方案：Kind（Kubernetes in Docker）和 Minikube。

4.3.1 Kind 集群（推荐）

Kind 将 Kubernetes 节点运行在 Docker 容器中，启动快、资源占用低，适合 CI/CD 和本地调试。

1. 安装 Docker：参考 https://docs.docker.com/get-docker/。
2. 安装 Kind：

   # Linux / macOS
   curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.24.0/kind-$(uname)-amd64
   chmod +x ./kind && sudo mv ./kind /usr/local/bin/kind
   
   # Windows (PowerShell)
   curl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.24.0/kind-windows-amd64
   Move-Item .\kind-windows-amd64.exe c:\kind\kind.exe

3. 创建集群：

   kind create cluster --name operator-dev

4. 验证集群：

   kubectl cluster-info --context kind-operator-dev

4.3.2 Minikube 集群（备选）

Minikube 在虚拟机或容器中运行单节点集群，支持更多 Kubernetes 特性（如 LoadBalancer、Ingress、Dashboard）。

1. 安装 Minikube：

   # Linux / macOS
   curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
   sudo install minikube-linux-amd64 /usr/local/bin/minikube
   
   # Windows (Chocolatey)
   choco install minikube

2. 启动集群：

   minikube start --driver=docker --cpus=4 --memory=8192

3. 验证集群：

   minikube status
   kubectl get nodes

4.3.3 两种方案对比

4.4 开发环境整体架构

下图展示了开发环境中各组件的关系：Go 工具链编译 Operator 二进制，Kubebuilder 生成项目骨架，Kind/Minikube 提供 Kubernetes API Server 和 etcd，Operator 通过 kubeconfig 与集群交互。

4.5 环境验证清单

完成搭建后，执行以下命令验证所有组件正常工作：

# 1. Go 版本
go version

# 2. Kubebuilder 版本
kubebuilder version

# 3. 集群状态（Kind 示例）
kind get clusters
kubectl cluster-info

# 4. 创建测试命名空间
kubectl create namespace operator-test
kubectl get ns operator-test

# 5. 部署测试 Pod
kubectl run nginx --image=nginx -n operator-test
kubectl get pods -n operator-test

4.6 常见问题与排查