2. 测试环境准备：Minikube、Kind、K3s 等本地集群搭建工具对比与选型，环境初始化最佳实践

在开展 Kubernetes 集群集成测试之前，搭建一个轻量、可复现、资源可控的本地测试环境是首要任务。本章将系统对比 Minikube、Kind、K3s 三款主流本地集群工具，从架构原理、资源开销、网络模型、适用场景四个维度进行深度分析，并给出环境初始化的标准化操作流程与避坑指南。

2.1 三款工具核心架构对比

下表从底层实现、节点模型、容器运行时、CNI 插件、存储支持等关键维度进行横向对比，帮助你在不同测试场景下做出合理选型。

2.2 架构对比 SVG 图：三款工具节点模型与网络拓扑

下图直观展示了 Minikube、Kind、K3s 在节点模型和网络平面上的核心差异，帮助你理解不同工具在数据平面和控制平面上的设计取舍。

2.3 环境初始化最佳实践

无论选择哪种工具，标准化的初始化流程都能显著降低环境不一致带来的测试干扰。以下是经过生产验证的初始化步骤，涵盖驱动选择、资源配置、插件安装和网络调优。

2.3.1 Minikube 初始化（推荐用于功能验证与网络策略测试）

# 1. 安装 Minikube（Linux / macOS / Windows WSL2）
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 2. 启动集群（指定驱动、资源、CNI）
minikube start \
  --driver=docker \
  --cpus=2 \
  --memory=4096 \
  --cni=cilium \
  --kubernetes-version=v1.28.3 \
  --container-runtime=containerd

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

# 4. 验证集群状态
kubectl cluster-info
kubectl get nodes -o wide
kubectl get pods -n kube-system

2.3.2 Kind 初始化（推荐用于 CI/CD 与多节点测试）

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

# 2. 创建多节点集群配置文件 kind-config.yaml
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
networking:
  podSubnet: "10.244.0.0/16"
  serviceSubnet: "10.96.0.0/12"
EOF

# 3. 启动集群
kind create cluster --name test-cluster --config kind-config.yaml

# 4. 安装 CNI（可选，默认 Kindnet 不支持 NetworkPolicy）
kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.27/manifests/calico.yaml

# 5. 验证
kubectl get nodes
kubectl get pods -n kube-system

2.3.3 K3s 初始化（推荐用于边缘模拟与资源受限环境）

# 1. 安装 K3s（单节点 Server + Agent 一体）
curl -sfL https://get.k3s.io | sh -s - \
  --write-kubeconfig-mode=644 \
  --disable=traefik \
  --disable=servicelb \
  --flannel-backend=host-gw \
  --kube-apiserver-arg="--service-cluster-ip-range=10.43.0.0/16"

# 2. 配置 kubectl 访问
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodes

# 3. 安装 Helm（用于后续部署测试组件）
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

# 4. 验证核心组件
kubectl get pods -n kube-system
kubectl get svc -n kube-system

2.4 环境初始化后验证清单

无论使用哪种工具，初始化完成后都应执行以下验证步骤，确保集群基础能力符合集成测试要求。

2.5 选型决策流程 SVG 图

下图以决策树的形式，帮助你根据测试场景、资源限制和功能需求快速选定最合适的本地集群工具。

2.6 环境初始化常见问题与解决方案

• 问题：Minikube 启动后 Pod 无法跨节点通信
  原因：默认 CNI 为 bridge 模式，不支持跨节点路由。
  解决方案：使用 minikube start --cni=cilium 或 --cni=calico 重新创建集群。
• 问题：Kind 集群中 NodePort 无法从宿主机访问
  原因：未配置 extraPortMappings。
  解决方案：在 Kind 配置文件中为控制平面节点添加 extraPortMappings，将容器端口映射到宿主机。
• 问题：K3s 安装后 kubectl 命令提示权限不足
  原因：kubeconfig 文件权限为 600，当前用户无读取权限。
  解决方案：执行 sudo chmod 644 /etc/rancher/k3s/k3s.yaml 或使用 --write-kubeconfig-mode=644 参数重新安装。
• 问题：所有工具中 CoreDNS Pod 处于 CrashLoopBackOff 状态
  原因：Pod 网络 CIDR 与宿主机网络冲突。
  解决方案：在启动参数中指定不冲突的 --service-cluster-ip-range 和 --pod-network-cidr。