📚 课程目录第3章开发环境搭建

3. 开发环境搭建：Go语言环境配置、gRPC工具链安装、protobuf编译环境、Kubernetes集群准备

CSI（Container Storage Interface）驱动的开发依赖于一套精确配置的本地环境。本章将引导你完成从Go语言基础环境、gRPC与Protocol Buffers工具链，到Kubernetes集群的完整搭建流程。所有步骤均经过验证，确保你能够无缝进入后续的驱动编码阶段。

3.1 Go语言环境配置

CSI驱动使用Go语言编写，官方推荐使用 Go 1.21+ 版本以获得对泛型及现代依赖管理的最佳支持。以下是标准配置流程：

下载与安装：访问 go.dev/dl，选择对应操作系统的安装包。Linux/macOS建议使用 tar.gz 解压至 /usr/local。
设置环境变量：在 ~/.bashrc 或 ~/.zshrc 中添加以下内容：

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

验证安装：执行 go version 确认版本输出。
配置Go Proxy（国内环境推荐）：

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

版本选择建议：CSI spec v1.9+ 要求 Go 1.21 以上。若使用旧版 Kubernetes（如 v1.23），Go 1.19 仍可兼容，但建议统一使用最新稳定版。

3.2 gRPC工具链安装

CSI基于gRPC通信，因此必须安装 protoc 编译器及Go插件。下表列出了核心组件及其用途：

组件	版本要求	安装方式	用途
`protoc`	>= 3.21	GitHub Releases 下载二进制	编译 .proto 文件
`protoc-gen-go`	v1.31+	`go install google.golang.org/protobuf/cmd/protoc-gen-go@latest`	生成Go结构体代码
`protoc-gen-go-grpc`	v1.3+	`go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest`	生成gRPC服务端/客户端代码

安装步骤：

# 1. 安装 protoc（以 Linux amd64 为例）
PB_REL="https://github.com/protocolbuffers/protobuf/releases"
curl -LO $PB_REL/download/v25.1/protoc-25.1-linux-x86_64.zip
unzip protoc-25.1-linux-x86_64.zip -d $HOME/.local
export PATH="$PATH:$HOME/.local/bin"

# 2. 安装 Go 插件
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.31.0
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.3.0

# 3. 验证
protoc --version
protoc-gen-go --version

路径陷阱：确保 $GOPATH/bin 在 $PATH 中，否则 protoc 无法找到 protoc-gen-go 插件。执行 which protoc-gen-go 确认。

3.3 Protobuf编译环境与CSI Proto文件

CSI驱动需要编译 csi.proto 文件。该文件定义了Identity、Controller、Node三个核心gRPC服务的接口。下图展示了从proto文件到Go代码的编译流程：

获取CSI Proto文件：

git clone https://github.com/container-storage-interface/spec.git
cd spec
protoc --proto_path=. --go_out=. --go-grpc_out=. csi.proto

编译后会在当前目录生成 csi.pb.go 和 csi_grpc.pb.go 两个文件。后续开发中，你只需引用这两个文件中的类型和接口，无需手动定义gRPC服务。

3.4 Kubernetes集群准备

CSI驱动的最终运行环境是Kubernetes集群。本地开发阶段，推荐使用 kind（Kubernetes in Docker）或 minikube 搭建单节点集群。下表对比了两种方案的适用场景：

工具	启动速度	资源占用	适用场景
kind	快（30秒）	低	CI/CD、快速原型验证、多节点模拟
minikube	中等（1-2分钟）	中	本地开发、需要NodePort/存储卷挂载

使用kind搭建集群（推荐）：

# 安装 kind
go install sigs.k8s.io/kind@v0.20.0

# 创建集群配置文件 kind-config.yaml
cat <<EOF > kind-config.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  extraMounts:
  - hostPath: /var/lib/csi-test
    containerPath: /var/lib/csi-test
EOF

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

# 验证集群
kubectl cluster-info --context kind-csi-dev

  关键配置说明：extraMounts 将宿主机的 /var/lib/csi-test 目录挂载到kind节点内。CSI驱动在测试时需要访问宿主机上的临时存储后端（如本地目录或模拟设备），此挂载是后续功能验证的基础。

3.5 环境验证清单

完成上述步骤后，执行以下命令进行全链路验证：

# 1. Go 环境
go version
# 输出示例：go version go1.22.0 linux/amd64

# 2. gRPC 工具链
protoc --version
# 输出示例：libprotoc 25.1

# 3. 编译 CSI proto（无报错即成功）
cd $GOPATH/src && git clone https://github.com/container-storage-interface/spec.git
cd spec && protoc --proto_path=. --go_out=. --go-grpc_out=. csi.proto
ls -la csi.pb.go csi_grpc.pb.go

# 4. Kubernetes 集群
kubectl get nodes
# 输出示例：NAME                 STATUS   ROLES           AGE   VERSION
#                csi-dev-control-plane   Ready    control-plane   5m    v1.28.0