3. 调度器插件开发环境搭建：Go语言环境、Kubernetes源码编译、本地集群搭建（Kind/K3s）

搭建一个稳定、可复现的开发环境是调度器插件开发的基石。本章将引导你完成从语言工具链到本地集群的全链路配置，确保后续的插件编码、编译与调试能够顺畅进行。整个环境搭建遵循“最小依赖、版本锁定、可容器化”的原则。

3.1 环境总览与版本矩阵

调度器插件与 Kubernetes 核心代码紧密耦合，因此 Go 版本、Kubernetes 版本与集群工具版本必须严格对齐。以下为推荐版本组合，建议在开发过程中锁定此矩阵，避免因版本漂移导致的不兼容问题。

3.2 Go 语言环境安装与配置

Go 是调度器插件的唯一编译语言。安装过程需注意 GOPATH 与 GOROOT 的隔离，以及模块代理的配置。

3.2.1 安装步骤

1. 下载二进制包： 从 go.dev/dl 获取 go1.21.3.linux-amd64.tar.gz。
2. 解压至指定目录： sudo tar -C /usr/local -xzf go1.21.3.linux-amd64.tar.gz
3. 配置环境变量： 将以下内容追加到 ~/.bashrc 或 ~/.zshrc。

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH
export GO111MODULE=on
export GOPROXY=https://goproxy.cn,direct

4. 验证安装： 执行 go version 应输出 go version go1.21.3 linux/amd64。

3.2.2 多版本管理（可选）

若需同时维护多个 Go 版本，推荐使用 g 工具：

# 安装 g
curl -sSL https://git.io/g-install | sh
# 安装并切换版本
g install 1.21.3
g use 1.21.3

3.3 Kubernetes 源码编译

调度器插件开发需要直接修改或扩展 k8s.io/kubernetes 中的调度框架代码。因此，本地必须能够完整编译 Kubernetes 源码。

3.3.1 克隆源码并切换分支

mkdir -p $GOPATH/src/k8s.io
cd $GOPATH/src/k8s.io
git clone https://github.com/kubernetes/kubernetes.git
cd kubernetes
git checkout v1.28.3

3.3.2 编译 kube-scheduler 二进制

Kubernetes 使用 make 与 Bazel 两套构建系统。对于调度器插件开发，推荐使用 make 快速编译单个组件：

# 仅编译 kube-scheduler，耗时约 2-3 分钟
make WHAT=cmd/kube-scheduler

# 编译产物位于 _output/bin/kube-scheduler
ls -lh _output/bin/kube-scheduler

3.3.3 验证编译产物

./_output/bin/kube-scheduler --version
# 输出示例：Kubernetes v1.28.3

3.4 本地集群搭建：Kind 与 K3s 双方案

本地集群用于运行自定义调度器并观察调度效果。Kind 提供多节点模拟，K3s 提供极简启动。建议两者都安装，根据场景切换。

3.4.1 使用 Kind 搭建多节点集群

Kind 将 Kubernetes 节点运行在 Docker 容器中，支持自定义 kubelet 配置，非常适合调度器插件的集成测试。

安装 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

创建集群配置文件 kind-config.yaml：

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

启动集群：

kind create cluster --config kind-config.yaml --name scheduler-dev
# 验证节点状态
kubectl get nodes

3.4.2 使用 K3s 搭建单节点集群

K3s 是 Rancher 推出的轻量级发行版，资源占用极低，适合在笔记本上进行快速原型验证。

# 一键安装 K3s
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.28.3+k3s1 sh -

# 配置 kubeconfig
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodes

3.5 环境搭建流程总览

下图展示了从 Go 安装到集群就绪的完整链路，以及各步骤之间的依赖关系。

3.6 环境验证清单

完成上述步骤后，建议执行以下验证脚本，确保所有组件正常工作：

#!/bin/bash
# 环境验证脚本

echo "=== Go 版本 ==="
go version || { echo "❌ Go 未安装"; exit 1; }

echo "=== K8s 编译产物 ==="
ls $GOPATH/src/k8s.io/kubernetes/_output/bin/kube-scheduler || { echo "❌ kube-scheduler 未编译"; exit 1; }

echo "=== Kind 版本 ==="
kind version || { echo "❌ Kind 未安装"; exit 1; }

echo "=== K3s 状态 ==="
k3s --version 2>/dev/null || echo "⚠ K3s 未安装（可选）"

echo "=== 集群节点 ==="
kubectl get nodes || { echo "❌ 集群未就绪"; exit 1; }

echo "=== Helm 版本 ==="
helm version --short || { echo "❌ Helm 未安装"; exit 1; }

echo "✅ 环境验证通过！"

3.7 常见问题与避坑指南

• Go 版本过高导致编译失败： K8s 1.28 不支持 Go 1.22+ 的新语法。务必使用 go1.21.x。
• Kind 集群无法拉取镜像： 国内环境需配置 Docker 镜像加速器，或在 Kind 配置中指定 kubeadmConfigPatches 设置 imageRepository: registry.cn-hangzhou.aliyuncs.com/google_containers。
• K3s 默认调度器抢占端口： 若需在 K3s 上运行自定义调度器，需修改 /etc/systemd/system/k3s.service 中的 --disable-scheduler 参数，或使用 --kube-scheduler-arg 指定自定义调度器镜像。
• 编译内存不足： 编译 K8s 源码建议分配至少 4GB 内存。若使用虚拟机或 WSL2，请确保资源充足。