容器与云原生 / 系统课时

搭建本地实验集群

搭建本地实验集群

本节完成一个可反复重建的本地 Kubernetes 实验环境:安装 kubectl 与 kind,使用容器运行时创建单节点集群,并通过上下文、节点状态和 API Server 连通性确认环境真正可用。

学习目标

  • 安装并验证 kubectl 与 kind 两个命令行工具。
  • 创建名为 k8s-lab 的本地 kind 集群并理解其基本拓扑。
  • 使用 kubectl 检查当前上下文、节点 Ready 状态和控制面连通性。

前置检查

kind 会在本机容器中运行 Kubernetes 节点,因此需要先准备 Docker 或 Podman 等受支持的容器运行时。

先确认容器运行时已经启动。以下以 Docker 为例。

bash
docker version --format '{{.Server.Version}}'

预期输出

text
<VERSION>

<VERSION> 会随本机安装版本变化。如果命令报无法连接 daemon,应先启动 Docker,再继续后续步骤。

安装并验证命令行工具

macOS 使用 Homebrew 时可以安装 kubectl 和 kind;Windows 可用 winget 安装 Kubernetes.kubectl 与 Kubernetes.kind。

macOS 可执行:

bash
brew install kubectl kind

预期结果

text
安装命令成功结束,kubectl 与 kind 被加入 PATH;具体包管理器日志和版本号会因时间而变化。

Windows PowerShell 可执行:

powershell
winget install -e --id Kubernetes.kubectl
winget install Kubernetes.kind

预期结果

text
两个安装任务均成功结束;具体下载进度、来源和版本号会因时间而变化。

无论使用哪种系统,统一用版本命令验收安装结果。

bash
kubectl version --client
kind version

预期输出

text
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 节点。

kubectl 与 kind 单节点集群拓扑

创建集群并等待控制面就绪:

bash
kind create cluster --name k8s-lab --wait 60s

预期输出

text
Creating cluster "k8s-lab" ...
Set kubectl context to "kind-k8s-lab"

创建过程还会输出节点准备、网络和存储组件等阶段,具体行数与版本可能不同;关键是命令成功结束并设置 kind-k8s-lab 上下文。

检查上下文与节点

先确认 kubectl 当前指向刚创建的集群,再检查节点状态。

bash
kubectl config current-context
kubectl get nodes

预期输出

text
kind-k8s-lab
NAME                    STATUS   ROLES           AGE      VERSION
k8s-lab-control-plane   Ready    control-plane   <TIME>   v<VERSION>

<TIME> 和 <VERSION> 会按实际环境变化。最重要的验收条件是节点 STATUS 为 Ready。

最后检查 API Server 连通性:

bash
kubectl cluster-info --context kind-k8s-lab

预期输出

text
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 是否真的创建成功;必要时删除后重建。

bash
kind delete cluster --name k8s-lab
kind create cluster --name k8s-lab --wait 60s

预期输出

text
Deleted nodes: ["k8s-lab-control-plane"]
Creating cluster "k8s-lab" ...
Set kubectl context to "kind-k8s-lab"

完成这些检查后,本地实验环境的最低验收标准就是:kind 集群存在、当前上下文正确、节点为 Ready、kubectl cluster-info 能访问控制面。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建本地实验集群

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通