Skip to content

Kind 项目介绍 ​

Kind(Kubernetes in Docker)是一个在单台主机上运行 Kubernetes 集群的工具。它将每个 Kubernetes 节点封装为一个 Docker 容器,容器内运行 systemd、containerd、kubelet 与 kubeadm;多个这样的容器组成一个完整集群,其行为与上游 Kubernetes 保持一致。

Kind 由 Kubernetes SIG Testing 维护,最初用于测试 Kubernetes 自身,后来成为本地开发、CI 和多节点行为验证的常用工具。它是 CNCF 认证的一致性 Kubernetes 安装器,但并非 CNCF 托管项目。前者说明 Kind 创建的集群能够通过上游一致性测试,后者涉及项目治理,两者不应混淆。

设计目标 ​

Kind 解决的核心问题是本地 Kubernetes 环境的一致性与可重复性。围绕这一目标,它形成了四项设计特征:

  • 集群由容器组成:不依赖虚拟机、云主机或外部节点,所有节点都是本机 Docker 容器。
  • 版本由镜像固定:Kubernetes 版本由 kindest/node 镜像决定,避免宿主机工具链差异带来的漂移。
  • 拓扑由配置声明:节点数量、角色、端口映射和 kubeadm 参数都写在集群配置中,可随代码一起版本化。
  • 生命周期可反复重建:创建与删除都是显式命令,适合在 CI 中为每次任务准备独立集群。

这些特征决定了 Kind 的适用边界:它面向测试与开发,而非生产环境。

总体架构 ​

Kind 的架构可以按四层理解:宿主机的 Docker 引擎、Docker 网络、节点容器,以及节点容器内部的 Kubernetes 组件与业务 Pod。

Kind 总体架构

对象说明
kind CLI管理入口。单个 Go 二进制,通过 Docker API 创建、启动、检查和删除节点容器。
Cluster集群实例。一组带有相同 kind 标签的节点容器,由 --name 区分。
Node container节点载体。运行 systemd 与 Kubernetes 组件的 Docker 容器,分为 control-plane 与 worker。
Node image版本载体。kindest/node:vX.Y.Z@sha256:...,预装指定版本的 Kubernetes 组件。
Cluster config拓扑声明。kind.x-k8s.io/v1alpha4 YAML,描述节点、网络、端口映射与 kubeadm 补丁。
Docker network节点网络。Kind 创建的桥接网络,为节点容器分配 IP 并承载节点间通信。
kubeconfig访问配置。宿主机上的集群访问凭证,context 名为 kind-<集群名>。

需要区分两个“节点”概念:Kubernetes Node 是集群中的逻辑对象,Kind node container 是承载该对象的 Docker 容器。kubectl get nodes 查看的是前者,docker ps 查看的是后者。

工作原理 ​

集群创建流程 ​

执行 kind create cluster 时,Kind 按以下顺序完成集群初始化:

  1. 读取集群配置,确定节点数量、角色、镜像、网络参数和端口映射。
  2. 调用 Docker API 创建节点容器,并将节点接入 Kind 管理的 Docker 网络。
  3. 等待节点容器进入可引导状态,完成目录挂载、kubeconfig 写入和镜像预加载。
  4. 第一个 control-plane 节点执行 kubeadm init,其余 control-plane 节点执行 kubeadm join --control-plane,worker 节点执行普通 kubeadm join。
  5. 安装默认 CNI 与默认 StorageClass,并将 kubeconfig 合并到宿主机。
  6. 集群就绪后,通过 kubectl --context kind-<集群名> 访问 API Server;删除时,Kind 按标签清理全部节点容器与网络。

从职责划分看,Docker 提供节点载体,kubeadm 完成集群引导,kubeconfig 将集群访问权交还给宿主机的 kubectl。

节点容器内部 ​

kindest/node 不是普通应用镜像,而是一套包含 systemd 引导能力、容器运行时和 Kubernetes 组件的节点根文件系统。容器启动分为四个阶段:

  1. 准备:入口进程暂缓启动,等待 Kind 完成目录挂载、配置写入与镜像预加载。
  2. 引导 init:收到启动信号后,systemd 拉起 containerd 与 kubelet。
  3. 组建集群:control-plane 执行 kubeadm init 或 kubeadm join --control-plane,worker 执行 kubeadm join。
  4. 安装插件:应用默认 CNI 与 StorageClass,并导出 kubeconfig。

因此,Kind 集群同时存在两套观察视角:Docker 视角看到的是 kind-control-plane、kind-worker 等容器;Kubernetes 视角看到的是容器内部注册到 API Server 的 Node。

网络模型 ​

Kind 的网络分为三层:

  • 节点网络:Kind 创建名为 kind 的 Docker 桥接网络,每个节点容器获得独立 IP,节点间通过该网络通信。
  • Pod 网络:集群使用独立的 Pod CIDR,默认 10.244.0.0/16,由 kindnetd 负责连通。
  • Service 网络:默认 10.96.0.0/12,由 kube-proxy 维护转发规则。Kind 默认使用 iptables 模式,Kubernetes v1.31 起可配置 nftables。

从宿主机访问集群有三条路径:

访问路径适用场景实现方式
API Serverkubectl、CI、远程调试Kind 将 API Server 端口映射到宿主机,kubeconfig 直接可用
端口映射NodePort、Ingress、固定端口服务在集群配置中声明 extraPortMappings,将宿主机端口映射到节点容器端口
临时转发本地开发、一次性验证使用 kubectl port-forward,不修改集群配置

在 macOS 与 Windows 上,Docker 运行于虚拟机内部,节点容器 IP 无法从宿主机直接路由。访问工作负载必须使用端口映射或 port-forward。Linux 环境下节点 IP 可能可达,但为保持跨平台一致性,仍建议采用端口映射。

镜像与存储 ​

镜像分发 ​

Kind 节点运行独立的 containerd,与宿主机的 Docker 镜像库相互隔离。docker build 生成的镜像不会自动出现在节点中,需要通过 kind load docker-image 显式导入:

bash
docker build -t kind-demo:v1 ./app
kind load docker-image kind-demo:v1 --name kind-multi

kind load docker-image 默认将镜像导入所有节点,使 Pod 无论调度到哪个节点都能使用本地镜像。若只导入部分节点,则必须通过节点亲和性或固定调度保证 Pod 落在已有镜像的节点上。

镜像标签应保持固定。Kubernetes 对 :latest 默认采用 Always 拉取策略,会绕过本地镜像访问镜像仓库。工作负载清单中应同时声明 imagePullPolicy: IfNotPresent,使节点优先使用本地副本。

存储 ​

Kind 默认安装 local-path-provisioner,并创建名为 standard 的默认 StorageClass。PersistentVolume 落在节点容器内部的本地路径上,适用于演示与测试,但不提供共享存储能力。

这一实现带来两个限制:

  • PersistentVolume 与节点绑定。使用 PVC 的 Pod 被重新调度到其他节点后,未必能访问原有数据。
  • 删除集群会删除节点容器及其本地数据。需要保留的数据应通过 extraMounts 挂载到宿主机目录,或使用外部存储。

无状态工作负载应优先使用 emptyDir 或不声明卷。验证 StatefulSet 时,应接受数据仅存在于单节点本地,或通过亲和性将 Pod 固定在相同节点。

多节点与高可用 ​

Kind 支持多节点与多 control-plane 拓扑:

  • 单 control-plane + 多 worker:常见的开发与 CI 形态,用于验证调度、亲和性、滚动更新和跨节点网络。
  • 三个 control-plane + 多 worker:模拟高可用集群。三个 control-plane 各自运行 etcd 成员并形成多数派;Kind 额外启动负载均衡容器,将 API Server 请求分发到存活的 control-plane。

Kind 默认移除 control-plane 的 NoSchedule 污点,因此单节点集群可以直接运行工作负载。多节点环境中,如果要求业务仅运行在 worker 上,需要手动恢复该污点。

生命周期 ​

Kind 将集群状态保存在 Docker 容器及其标签中,不在宿主机维护独立的集群目录。常用生命周期命令如下:

  • kind create cluster --name <集群名>:创建集群,可通过 --image 固定节点镜像。
  • kind get clusters:列出本机全部集群。
  • kind get nodes --name <集群名>:列出指定集群的节点容器。
  • kind export kubeconfig --name <集群名>:重新导出 kubeconfig。
  • kind delete cluster --name <集群名>:删除节点容器、Docker 网络及对应 kubeconfig 条目。

kubeconfig 默认合并到 ~/.kube/config,context 名为 kind-<集群名>。存在多个集群时,应通过 --context 明确指定目标集群。

能力边界 ​

Kind 的定位是本地测试与开发环境。以下限制来自其实现方式,而非配置差异:

  • 并非多机集群:所有节点共享一台宿主机、一个内核和一套 Docker 资源,无法模拟真实的跨机故障域。
  • 缺少云厂商能力:默认没有 LoadBalancer 实现,type: LoadBalancer 的 Service 不会获得外部 IP,需要额外组件,或改用 NodePort 与 Ingress。
  • 存储不具备共享性:默认 StorageClass 为节点本地盘,Pod 迁移后数据不会随之迁移。
  • 资源受 Docker 约束:Docker Desktop 的 CPU 与内存上限即集群上限。多节点集群与镜像构建建议至少 8 GB 内存。
  • 不构成安全边界:节点容器共享宿主机内核,不应运行不可信工作负载。
  • 镜像架构必须匹配:Apple Silicon 默认构建 arm64 镜像,节点镜像也必须为 arm64;跨架构构建需显式指定 --platform。

常见误区及对应处理:

误区实际行为处理方式
构建镜像后直接部署节点内不存在该镜像,Pod 报 ErrImagePull先执行 kind load docker-image
使用 :latest 标签默认 Always 拉取,本地镜像被忽略使用固定标签并设置 IfNotPresent
在 macOS 上直接访问节点 IP节点位于 Docker 虚拟机内,宿主机不可路由使用 extraPortMappings 或 port-forward
将 Kind 用作生产集群单主机、无故障域、无云集成仅用于开发、测试与 CI
删除集群后仍期望保留数据节点容器与本地卷一并删除挂载宿主机目录或使用外部存储

与同类工具的选型 ​

本地 Kubernetes 工具的差异主要体现在节点形态、是否运行上游 Kubernetes,以及内置组件的完整程度:

工具节点形态适用场景主要限制
Kind每节点一个 Docker 容器,支持多节点测试上游 Kubernetes、CI、多节点行为验证不内置 Ingress、LoadBalancer 与 Dashboard
Minikube以单节点为主,部分驱动支持多节点学习、日常开发、使用官方 addons启动开销较大,多节点能力依驱动而异
k3d每节点一个容器,运行 k3s轻量多节点、边缘或资源受限环境运行 k3s 发行版,与上游 Kubernetes 存在差异
Docker Desktop Kubernetes单个内置节点已使用 Docker Desktop 的开发者快速试用单节点、配置项有限,不适合多节点验证

选型可依据目标判断:

  • 需要验证上游 Kubernetes 行为、进行多节点调度实验或构建 CI 环境时,选择 Kind。
  • 需要开箱即用的学习环境,并依赖 Dashboard、Ingress 等 addon 时,选择 Minikube。
  • 需要更轻量的多节点集群,且能够接受 k3s 与上游差异时,选择 k3d。
  • 仅需在 Docker Desktop 中零配置试用时,选择内置 Kubernetes。

Kind 的核心价值在于节点形态与上游 Kubernetes 一致,且集群可以按声明重复创建,因此适合验证节点变更、污点调整和调度策略等行为。

版本与参考 ​

Kind v0.33.0 的默认节点镜像为 kindest/node:v1.37.0,同时支持 v1.36.4、v1.35.8 与 v1.34.11。Kind 版本与受支持节点镜像以官方 release notes为准;集群配置字段可参考官方配置文档。

~~~我是有底线的~~~