容器与云原生 / 系统课时
搭建本地实验集群
搭建本地实验集群
本节完成一个可反复重建的本地 Kubernetes 实验环境:安装 kubectl 与 kind,使用容器运行时创建单节点集群,并通过上下文、节点状态和 API Server 连通性确认环境真正可用。
学习目标
- 安装并验证
kubectl与 kind 两个命令行工具。 - 创建名为
k8s-lab的本地 kind 集群并理解其基本拓扑。 - 使用
kubectl检查当前上下文、节点 Ready 状态和控制面连通性。
前置检查
kind 会在本机容器中运行 Kubernetes 节点,因此需要先准备 Docker 或 Podman 等受支持的容器运行时。
先确认容器运行时已经启动。以下以 Docker 为例。
docker version --format '{{.Server.Version}}'预期输出
<VERSION><VERSION> 会随本机安装版本变化。如果命令报无法连接 daemon,应先启动 Docker,再继续后续步骤。
安装并验证命令行工具
macOS 使用 Homebrew 时可以安装 kubectl 和 kind;Windows 可用 winget 安装 Kubernetes.kubectl 与 Kubernetes.kind。
macOS 可执行:
brew install kubectl kind预期结果
安装命令成功结束,kubectl 与 kind 被加入 PATH;具体包管理器日志和版本号会因时间而变化。Windows PowerShell 可执行:
winget install -e --id Kubernetes.kubectl
winget install Kubernetes.kind预期结果
两个安装任务均成功结束;具体下载进度、来源和版本号会因时间而变化。无论使用哪种系统,统一用版本命令验收安装结果。
kubectl version --client
kind version预期输出
Client Version: v<VERSION>
Kustomize Version: v<VERSION>
kind v<VERSION> go<VERSION> <OS>/<ARCH><VERSION> 是动态值,只要两个命令都能返回版本且没有 command not found,工具安装就通过。
创建 kind 集群
kind 的节点本质上运行在本机容器中,kubectl 则通过生成的 kubeconfig 上下文访问其中的 API Server。单节点实验环境只需要一个 control-plane 节点。

创建集群并等待控制面就绪:
kind create cluster --name k8s-lab --wait 60s预期输出
Creating cluster "k8s-lab" ...
Set kubectl context to "kind-k8s-lab"创建过程还会输出节点准备、网络和存储组件等阶段,具体行数与版本可能不同;关键是命令成功结束并设置 kind-k8s-lab 上下文。
检查上下文与节点
先确认 kubectl 当前指向刚创建的集群,再检查节点状态。
kubectl config current-context
kubectl get nodes预期输出
kind-k8s-lab
NAME STATUS ROLES AGE VERSION
k8s-lab-control-plane Ready control-plane <TIME> v<VERSION><TIME> 和 <VERSION> 会按实际环境变化。最重要的验收条件是节点 STATUS 为 Ready。
最后检查 API Server 连通性:
kubectl cluster-info --context kind-k8s-lab预期输出
Kubernetes control plane is running at https://127.0.0.1:<PORT><PORT> 是 kind 为本地 API Server 映射的动态端口。只要能得到控制面地址且命令正常返回,就说明 kubeconfig、网络映射和 API Server 三者已经连通。
常见失败处理
若 kind create cluster 卡在节点准备阶段,先检查容器运行时是否启动以及本机资源是否充足。若 kubectl 报上下文不存在,可执行 kind get clusters 确认 k8s-lab 是否真的创建成功;必要时删除后重建。
kind delete cluster --name k8s-lab
kind create cluster --name k8s-lab --wait 60s预期输出
Deleted nodes: ["k8s-lab-control-plane"]
Creating cluster "k8s-lab" ...
Set kubectl context to "kind-k8s-lab"完成这些检查后,本地实验环境的最低验收标准就是:kind 集群存在、当前上下文正确、节点为 Ready、kubectl cluster-info 能访问控制面。