使用kind快速搭建本地k8s集群

Kind是什么？

k8s集群的组成比较复杂，如果纯手工部署的话易出错且时间成本高。而本文介绍的Kind工具，能够快速的建立起可用的k8s集群，降低初学者的学习门槛。

Kind是Kubernetes In Docker的缩写，顾名思义，看起来是把k8s放到docker的意思。没错，kind创建k8s集群的基本原理就是：提前准备好k8s节点的镜像，通过docker启动容器，来模拟k8s的节点，从而组成完整的k8s集群。需要注意，kind创建的集群仅可用于开发、学习、测试等，不能用于生产环境。

kind有什么特点？

创建、启动k8s集群非常快速，资源消耗较低。
支持创建多节点的k8s集群，包括高可用模式。
kind 支持 Linux, macOS and Windows
它是CNCF认证的k8s集群安装方式之一

如何安装kind？

kind表现上就是一个二进制程序，下载对应版本并增加执行权限即可：

curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.11.1/kind-linux-amd64

chmod +x ./kind

mv ./kind /usr/bin/kind

kind version

如何通过kind新建k8s集群？

kubectl是与k8s交互的客户端命令工具，因此需要先安装此工具。

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

kubectl version --client

然后通过一行命令就能够快速的创建k8s集群：

root@e5pc-vm-01:~# kind create cluster --name myk8s-01

Creating cluster "myk8s-01" ...

 ✓ Ensuring node image (kindest/node:v1.21.1)

 ✓ Preparing nodes

 ✓ Writing configuration

 ✓ Starting control-plane ️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️️

 ✓ Installing CNI

 ✓ Installing StorageClass

Set kubectl context to "kind-myk8s-01"

You can now use your cluster with:

kubectl cluster-info --context kind-myk8s-01

Have a nice day!

至此已得到一个可用的k8s集群了：

root@e5pc-vm-01:~# kubectl get nodes

NAME                     STATUS   ROLES                  AGE   VERSION

myk8s-01-control-plane   Ready    control-plane,master   66s   v1.21.1

kind创建k8s集群的内幕

先查看多出来的docker镜像和容器：

root@e5pc-vm-01:~# docker images

REPOSITORY     TAG       IMAGE ID       CREATED        SIZE

ubuntu         latest    2b4cba85892a   2 days ago     72.8MB

kindest/node   <none>    32b8b755dee8   9 months ago   1.12GB

root@e5pc-vm-01:~# docker ps

CONTAINER ID   IMAGE                  COMMAND                  CREATED          STATUS          PORTS                       NAMES

b4bde05b0190   kindest/node:v1.21.1   "/usr/local/bin/entr…"   12 minutes ago   Up 12 minutes   127.0.0.1:42267->6443/tcp   myk8s-01-control-plane

创建过程大概是：先获取镜像kindest/node:v1.21.1，然后启动容器myk8s-01-control-plane，启动的容器就是这个k8s集群的master节点，显然此集群只有master节点。

同时，kind create cluster命令还是将此新建的k8s集群的连接信息写入当前用户(root)的kubectl配置文件中，从而让kubectl能够与集群交互。配置文件内容如下：

root@e5pc-vm-01:~# cat  .kube/config

apiVersion: v1

clusters:

- cluster:

    certificate-authority-data: xxxx

    server: https://127.0.0.1:42267

  name: kind-myk8s-01

contexts:

- context:

    cluster: kind-myk8s-01

    user: kind-myk8s-01

  name: kind-myk8s-01

current-context: kind-myk8s-01

kind: Config

preferences: {}

users:

- name: kind-myk8s-01

  user:

    client-certificate-data: xxxx

    client-key-data: xxxx

kind创建k8s集群的架构图为：

kind程序的完整用法

kind create cluster

--image 指定node镜像名称，默认是kindest/node
--name 指定创建集群的名称
--config kind-example-config.yaml
--kubeconfig string 指定生成的kubeconfig的文件路径。默认在$KUBECONFIG or $HOME/.kube/config
常用：kind create cluster --config=xxxcfg --name=xxxname

kind delete cluster xxxx
kind get clusters：查看kind创建所有的k8s集群
kind get kubeconfig --name 集群name【必须填写--name参数，默认name是kind】
kind completion
kind export kubeconfig --name=xxx --kubeconfig=kubeconfigpath

导出kind中的k8s集群的kubeconfig连接配置文件

kind的高级用法

1、通过配置文件创建k8s集群

前面展示的集群创建操作是最简单的单master集群，kind当然可以创建更完整的集群。这就需要用到配置文件模式来创建集群：

root@e5pc-vm-01:~# cat kindcfg-tccc.biz.yml

kind: Cluster

apiVersion: kind.x-k8s.io/v1alpha4

nodes:

- role: control-plane

- role: worker

- role: worker

- role: worker

root@e5pc-vm-01:~# kind create cluster --name myk8s-02 --config  ./kindcfg-tccc.biz.yml

2、设置新建的k8s集群从私有http仓库加载镜像

配置文件如下：

kind: Cluster

apiVersion: kind.x-k8s.io/v1alpha4

containerdConfigPatches:

- |-

  [plugins."io.containerd.grpc.v1.cri".registry.mirrors."harbor.xxxx.top:60666"]

    endpoint = ["http://harbor.xxxx.top:60666"]

nodes:

- role: control-plane

- role: worker

3、完整的配置文件示例

地址：https://raw.githubusercontent.com/kubernetes-sigs/kind/main/site/content/docs/user/kind-example-config.yaml

# this config file contains all config fields with comments

# NOTE: this is not a particularly useful config file

kind: Cluster

apiVersion: kind.x-k8s.io/v1alpha4

# patch the generated kubeadm config with some extra settings

kubeadmConfigPatches:

- |

  apiVersion: kubelet.config.k8s.io/v1beta1

  kind: KubeletConfiguration

  evictionHard:

    nodefs.available: "0%"

# patch it further using a JSON 6902 patch

kubeadmConfigPatchesJSON6902:

- group: kubeadm.k8s.io

  version: v1beta2

  kind: ClusterConfiguration

  patch: |

    - op: add

      path: /apiServer/certSANs/-

      value: my-hostname

# 1 control plane node and 3 workers

nodes:

# the control plane node config

- role: control-plane

# the three workers

- role: worker

- role: worker

- role: worker

总结

kind是学习和测试k8s集群时非常有帮助的工具。它启动快速，资源消耗很低，并且它也是CNCF认证兼容的安装工具之一，大家可放心使用。

参考资料

官方文档：https://kind.sigs.k8s.io/
GitHub主页：https://github.com/kubernetes-sigs/kind/