Kind: 如何快速搭建本地 K8s 开发环境？

上篇文章中我们讲到了 k8s 中有哪些扩展点，开始 Operator 开发相关之前我们需要先把本地环境搭建好

一、依赖检查

 

开始之前需要先检查一下

1.是否已经安装好了 Docker 环境

• 如果还没安装 Mac/Windows 的用户可以直接安装 Docker Desktop
• Windows 用户推荐使用 WSL2

2.是否已经安装好了 Golang 环境, Go 版本最好 >= 1.15

• 如果没有可以参考官方文档进行安装

二、使用 Kind 搭建本地开发环境

 

2.1 安装

如果本地存在 Golang 环境可以直接执行下方命令进行安装

1. GO111MODULE="on" go get sigs.k8s.io/kind@v0.10.0 && kind create cluster 

如果不想通过源码安装可以查看官方文档直接安装编译好的二进制文件

执行下方命令可以输出 kind 的版本就表示安装好了

1. ❯ kind version 
2. kind v0.10.0 go1.16 linux/amd64 

2.2 创建一个 K8s 集群

使用下方命令即可创建一个简单的单节点 K8s 集群

1. node create clutser 

集群的创建时间和你的网络环境以及机器的性能有关系，kind 会去 docker hub 上拉取 kindest/node 镜像，这个镜像大概有 400M 的大小，当出现下方的提示的时候就说明集群创建好了

1. ❯ kind create cluster 
2. Creating cluster "kind" ... 
3.  ✓ Ensuring node image (kindest/node:v1.20.2)
4.  ✓ Preparing nodes 
5.  ✓ Writing configuration
6.  ✓ Starting control-plane
7.  ✓ Installing CNI
8.  ✓ Installing StorageClass
9. Set kubectl context to "kind-kind" 
10. You can now use your cluster with: 
11.  
12. kubectl cluster-info --context kind-kind 
13.  
14. Thanks for using kind!

我们可以使用 kind get clusters 获取我们创建的集群列表，kind 支持创建多个集群，不手动指定集群名称的时候默认名为 kind ，我们也可以像下面一样在创建集群的时候使用 --name 指定集群名称

1. kind create cluster --name mohuishou 

可以看到我们两个集群都创建好了

1. ❯ kind get clusters 
2. kind 
3. mohuishou 

现在我们只需要一个集群，所以可以先使用 kind delete clusters mohuishou 将刚刚创建的集群先删除掉

2.3 使用集群

下面我们来看一下 kubectl 的常用命令是否都可以正常使用，并且部署一个简单的 web 服务试试

查看集群信息

1. ❯ kubectl  cluster-info --context kind-kind 
2. Kubernetes master is running at https://127.0.0.1:41801 
3. KubeDNS is running at https://127.0.0.1:41801/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy 
4.  
5. To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'. 

可以看到我们 k8s master 地址和 dns 的地址，注意一般情况下我们只创建一个集群不需要指定 --context cluster name 但是创建了多个集群时这个基本就是必须的一个命令了。如果不加这个参数可能会报下面的错误

1. The connection to the server localhost:8080 was refused - did you specify the right host or port? 

这是因为 kubectl默认连接的 apiserver 地址是 localhost:8080但是我们的 apiserver 地址不是这个所以报错。

为什么我们使用 --context cluster-name 就可以了呢?

这是因为 kind 在创建集群的时候会修改 $HOME/.kube/config 的配置，将集群的 apiserver 地址，证书等相关信息都自动写入进去了

每次命令都要加上这个参数好麻烦怎么办?

我们可以使用 kubectl config use-context context-name 来进行设置，设置好了之后我们后续就不用每次都加上 –context 的参数了，同时还可以通过 kubectl config current-context 查询我们当前默认操作的集群是哪一个

查看集群节点列表

可以发现我们部署的是一个单节点的 v1.20.2 的集群

1. ❯ kubectl get no 
2. NAME                 STATUS   ROLES                  AGE   VERSION 
3. kind-control-plane   Ready    control-plane,master   20m   v1.20.2 

部署一个 Nginx 服务

使用下方代码创建一个 nginx.yml 文件，然后使用 kubectl apply -f nginx.yml 就可以完成部署了

1. apiVersion: apps/v1 
2. kind: Deployment 
3. metadata: 
4.   name: nginx-deployment 
5.   labels: 
6.     app: nginx 
7. spec: 
8.   replicas: 3 
9.   selector: 
10.     matchLabels: 
11.       app: nginx 
12.   template: 
13.     metadata: 
14.       labels: 
15.         app: nginx 
16.     spec: 
17.       containers: 
18.         - name: nginx 
19.           image: nginx:1.14.2 
20.           ports: 
21.             - containerPort: 80 

查看当前 deployment 的状态

1. ❯ kubectl get deployment 
2. NAME               READY   UP-TO-DATE   AVAILABLE   AGE 
3. nginx-deployment   0/3     3            0           39s 

查看 pod 的状态

1. ❯ kubectl get pods          
2. NAME                                READY   STATUS    RESTARTS   AGE 
3. nginx-deployment-66b6c48dd5-2s5cb   1/1     Running   0          84s 
4. nginx-deployment-66b6c48dd5-8wf8b   1/1     Running   0          84s 
5. nginx-deployment-66b6c48dd5-zc6vd   1/1     Running   0          84s 

由于我们没有做服务暴露，所以是不能直接访问对应的服务的，我们可以用 kubectl提供的端口转发功能来讲流量从本地转发给 k8s 集群

1. ❯ kubectl port-forward nginx-deployment-66b6c48dd5-2s5cb 30080:80 
2. Forwarding from 127.0.0.1:30080 -> 80 
3. Forwarding from [::1]:30080 -> 80 
4. Handling connection for 30080 

我们访问 http://localhost:30080 就会发现这个熟悉的 nginx 界面

image-20210424210804343

到这里可以发现我们集群已经是可以使用了

2.4 进阶使用

2.4.1 创建一个多节点的集群

kind 默认创建的是一个单节点的集群，我们可以通过修改配置创建一个高可用的集群，我们创建一个 3 个 master 节点，两个 worker 节点的集群

1. kind create cluster --name mohuishou-ha --config kind-ha.yml 

1. kind: Cluster 
2. apiVersion: kind.x-k8s.io/v1alpha4 
3. nodes: 
4.   - role: control-plane 
5.   - role: control-plane 
6.   - role: control-plane 
7.   - role: worker 
8.   - role: worker 

看一下节点即可验证

1. ❯ kubectl --context kind-mohuishou-ha get no                  
2. NAME                          STATUS   ROLES                  AGE     VERSION 
3. mohuishou-ha-control-plane    Ready    control-plane,master   16m     v1.20.2 
4. mohuishou-ha-control-plane2   Ready    control-plane,master   14m     v1.20.2 
5. mohuishou-ha-control-plane3   Ready    control-plane,master   13m     v1.20.2 
6. mohuishou-ha-worker           Ready    <none>                 5m52s   v1.20.2 
7. mohuishou-ha-worker2          Ready    <none>                 5m52s   v1.20.2 

2.4.2 Load Image

一般来说我们在 k8s 内部署应用需要先把容器镜像推送到到镜像仓库当中，这样在本地开发的时候相对来说会比较麻烦，特别是镜像比较大的时候，往返会有两次网络消耗，为了解决这个问题我们可以使用 kind load 镜像的功能直接把镜像。

1. kind load docker-image my-custom-image-0 my-custom-image-1 --name kind 

排坑指南：load image 成功，但是部署 pod 报错

1. Failed to pull image "controller:latest": rpc error: code = Unknown desc = failed to pull and unpack image "docker.io/library/controller:latest": failed to resolve reference "docker.io/library/controller:latest": pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failed 

这个问题之前卡了我很久，还是有点坑

1.进入节点查看: 镜像是否存在

• 获取节点名

1. ▶ kubectl get nodes 
2. NAME                 STATUS   ROLES                  AGE    VERSION 
3. kind-control-plane   Ready    control-plane,master   2d1h   v1.20.2 

• 进入终端

1. docker exec -it kind-control-plane bash 

• 查看镜像是否存在，kind 创建的集群使用的是 containerd 所以我们使用 crictl 命令来获取

1. crictl img | grep controller 
2. docker.io/library/controller   latest    421cbf77618ba       72.1MB 

2.如果镜像存在，也就是我们上面看到的情况，这时候就要检查一下我们部署的 yaml 文件

1. kubectl -n node-pool-operator-system  get deployment -o yaml | grep imagePullPolicy 

是否存在: imagePullPolicy: Always 如果我们没有改 yaml 的话默认会是这个配置，这个配置会导致每次都去镜像仓库拉取镜像，改成 imagePullPolicy: IfNotPresent 就可以了

3.如果镜像不存在：这时候要检查一下有没有指定 cluster-name，在存在多个集群的情况下可能没有加载到我们想要的集群，加上 --name cluster-name 即可

总结

kind 在创建集群的时候实际上使用的是 kubeadm 所以还可以修改 kubeadm 的配置来修改默认的镜像地址，节点标签污点等信息，除此之外还可以配置 PV/PVC CNI 插件等配置，如果有需求的话可以查阅 kind 的官方文档

不过要注意的是 kind 不支持给运行的集群添加节点，如果需要多节点集群的话得提前规划好节点数量

参考文献

• kind – Configurationhttps://kind.sigs.k8s.io/docs/user/configuration/
• Docker Desktophttps://www.docker.com/products/docker-desktop
• WSL2https://docs.microsoft.com/en-us/windows/wsl/install-win10
• Getting Started - go.dev https://learn.go.dev/
• 使用 Kind 搭建你的本地 Kubernetes 集群https://segmentfault.com/a/1190000018720465

原文地址：https://mp.weixin.qq.com/s/N5RdUxUx4f58qXKL5ha0OQ