4. 环境搭建：安装 Minikube/Kind、安装 OPA Gatekeeper、安装 Operator SDK、配置开发环境

本章将指导你完成本地 Kubernetes 开发环境的完整搭建，包括集群创建、策略引擎部署、Operator 开发工具链安装以及 IDE 配置。所有组件均采用当前稳定版本，确保与后续章节的实践操作无缝衔接。

4.1 环境概览与版本选型

下表列出了本课程使用的核心工具及其推荐版本。请确保你的宿主机满足最低资源要求：4 核 CPU、8 GB 内存、20 GB 可用磁盘空间。

4.2 安装 Kubernetes 集群（Minikube / Kind）

我们提供两种集群方案：Minikube 适合单节点快速验证，Kind 适合模拟多节点集群。你可以根据开发场景选择其一，或两者都安装。

4.2.1 安装 Minikube

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

2. 启动集群（指定 Kubernetes 版本和资源配额）：

minikube start --kubernetes-version=v1.28.3 --cpus=4 --memory=8192 --driver=docker

3. 验证集群状态：

kubectl cluster-info
kubectl get nodes

4.2.2 安装 Kind

1. 安装 Kind：

curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-linux-amd64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

2. 创建多节点集群配置文件 kind-config.yaml：

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: worker
- role: worker

3. 启动集群：

kind create cluster --config kind-config.yaml --name opa-course

4. 验证集群：

kubectl cluster-info --context kind-opa-course
kubectl get nodes

4.3 安装 OPA Gatekeeper

Gatekeeper 作为 Kubernetes 的 准入控制器（Admission Controller），负责拦截资源创建/更新请求并执行 OPA 策略。我们使用 Helm 进行安装，以便后续版本管理。

1. 添加 Gatekeeper Helm 仓库：

helm repo add gatekeeper https://open-policy-agent.github.io/gatekeeper/charts
helm repo update

2. 安装 Gatekeeper（指定命名空间和版本）：

helm install gatekeeper gatekeeper/gatekeeper \
  --namespace gatekeeper-system \
  --create-namespace \
  --version 3.14.0

3. 验证安装：

kubectl get pods -n gatekeeper-system
kubectl get crd | grep gatekeeper

预期输出应包含 gatekeeper-xxx-xxx 三个 Pod（audit、controller-manager、webhook）以及 constrainttemplates.gatekeeper.sh 等 CRD。

4.4 安装 Operator SDK

Operator SDK 是构建 Kubernetes Operator 的官方框架。我们使用 Go 语言作为开发语言，因此需要先安装 Go 环境。

4.4.1 安装 Go

wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
go version  # 应输出 go1.21.5

4.4.2 安装 Operator SDK CLI

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

3. 验证安装：

operator-sdk version  # 应输出 v1.33.0

4.4.3 初始化第一个 Operator 项目（快速验证）

mkdir -p ~/operator-workspace && cd ~/operator-workspace
operator-sdk init --domain=example.com --repo=github.com/example/memcached-operator
tree .  # 查看项目骨架结构

如果看到 go.mod、main.go、Makefile 等文件，说明 Operator SDK 安装成功。

4.5 配置开发环境

高效的开发环境能显著提升 Operator 和策略的开发效率。以下配置基于 VS Code，但同样适用于 JetBrains GoLand。

4.5.1 必备 VS Code 扩展

4.5.2 配置 kubectl 上下文自动切换

使用 kubectx 和 kubens 工具快速切换集群和命名空间：

sudo git clone https://github.com/ahmetb/kubectx /opt/kubectx
sudo ln -s /opt/kubectx/kubectx /usr/local/bin/kubectx
sudo ln -s /opt/kubectx/kubens /usr/local/bin/kubens

# 设置默认命名空间为 gatekeeper-system
kubens gatekeeper-system

4.5.3 配置 Rego 开发辅助工具

安装 opa 命令行工具，用于本地测试 Rego 策略：

curl -L -o opa https://openpolicyagent.org/downloads/v0.58.0/opa_linux_amd64_static
chmod +x opa
sudo mv opa /usr/local/bin/opa
opa version  # 验证安装

4.6 环境验证清单

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

# 1. 集群状态
kubectl get nodes

# 2. Gatekeeper Pod 运行状态
kubectl get pods -n gatekeeper-system

# 3. Operator SDK 可用
operator-sdk version

# 4. Rego 策略本地测试
echo 'package test
allow { true }' | opa eval --stdin-input '{"input": {}}' 'data.test.allow'

# 5. 镜像构建测试（可选）
cd ~/operator-workspace/memcached-operator
make docker-build IMG=test:latest

4.7 环境架构总览

下图展示了本地开发环境的完整组件关系与数据流：

4.8 常见问题与排错