是我很喜欢也一直在参与的项目,我计划将 Kind 相关的文章写成一个系列。(flag++) 这是第一篇。
Kind 介绍
Kind 是 Kubernetes In Docker 的缩写,顾名思义是使用 Docker 容器作为 Node 并将 Kubernetes 部署至其中的一个工具。中也把 Kind 作为一种本地集群搭建的工具进行推荐。
安装
二进制安装
Kind 使用 Golang 进行开发,在 页面,已经上传了构建好的二进制,支持多种操作系统,可直接按需下载进行使用。
e.g.
# 下载最新的 0.2.0 版本wget -O /usr/local/bin/kind https://github.com/kubernetes-sigs/kind/releases/download/0.2.0/kind-linux-amd64 && chmod +x /usr/local/bin/kind复制代码
通过源码安装
如果你本地已经配置好了 ,那你可以直接通过源码进行安装。
e.g.
go get -u sigs.k8s.io/kind复制代码
运行完上述命令后,会将 kind
的可执行文件放到 $(go env GOPATH)/bin
文件夹内,你可能需要将此目录加入到 $PATH
中。
或者也可以先 clone 源代码再通过 go build
进行构建。
依赖
-
Kind 的主要功能目前需要有 Docker 环境的支持,可参考 进行安装。
-
如果需要操作集群,则需要安装
kubectl
命令行。安装方法可参考
搭建单节点集群
以下的演示均使用最新的代码(即通过源码安装)。
基础用法
搭建单节点集群是 Kind 最基础的功能。
e.g.
master $ kind create cluster --name moeloveCreating cluster "moelove" ... ✓ Ensuring node image (kindest/node:v1.13.4) ? ✓ Preparing nodes ? ✓ Creating kubeadm config ? ✓ Starting control-plane ?️Cluster creation complete. You can now use the cluster with:export KUBECONFIG="$(kind get kubeconfig-path --name="moelove")"kubectl cluster-info复制代码
以上命令中, --name
是可选参数,如不指定,默认创建出来的集群名字为 kind
。
我们根据命令执行完的输出进行操作:
master $ export KUBECONFIG="$(kind get kubeconfig-path --name="moelove")"master $ kubectl cluster-infoKubernetes master is running at https://localhost:34458KubeDNS is running at https://localhost:34458/api/v1/namespaces/kube-system/services/kube-dns:dns/proxyTo further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.master $ kubectl get nodesNAME STATUS ROLES AGE VERSIONmoelove-control-plane Ready master 2m v1.13.4复制代码
以上命令中,kind get kubeconfig-path --name="moelove"
会返回该指定集群配置文件所在的路径。
可以看到单节点的 Kubernetes 已经搭建成功。
注意
- 默认情况下,Kind 会先下载
kindest/node:v1.13.4
镜像,该镜像目前托管于 Docker Hub 上,下载时间取决于网络状况。 - Kind 实际使用
kubeadm
进行集群的创建,对kubeadm
有所了解的人都知道它默认使用的镜像在国内下载不到,所以需要自己解决网络问题。或者参考下面的方式:
Kind 在创建集群的时候,支持通过 --config
的参数传递配置文件给 Kind,在国内,我们可以通过使用国内镜像源的方式来加速集群的创建。(这个方法也适用于直接通过 kubeadm 搭建 Kubernetes 集群)
我们先通过以下命令删除刚才搭建的集群:
master $ kind delete cluster --name moeloveDeleting cluster "moelove" ...$KUBECONFIG is still set to use /root/.kube/kind-config-moelove even though that file has been deleted, remember to unset it复制代码
接下来,将下面的配置内容保存至一个 YAML 文件中,比如名为 kind-config.yaml
kind: ClusterapiVersion: kind.sigs.k8s.io/v1alpha3kubeadmConfigPatches:- | apiVersion: kubeadm.k8s.io/v1beta1 kind: ClusterConfiguration metadata: name: config networking: serviceSubnet: 10.0.0.0/16 imageRepository: registry.aliyuncs.com/google_containers nodeRegistration: kubeletExtraArgs: pod-infra-container-image: registry.aliyuncs.com/google_containers/pause:3.1- | apiVersion: kubeadm.k8s.io/v1beta1 kind: InitConfiguration metadata: name: config networking: serviceSubnet: 10.0.0.0/16 imageRepository: registry.aliyuncs.com/google_containersnodes:- role: control-plane复制代码
我们使用该配置文件搭建集群。
master $ kind create cluster --name moelove --config kind.yamlCreating cluster "moelove" ... ✓ Ensuring node image (kindest/node:v1.13.4) ? ✓ Preparing nodes ? ✓ Creating kubeadm config ? ✓ Starting control-plane ?️Cluster creation complete. You can now use the cluster with:export KUBECONFIG="$(kind get kubeconfig-path --name="moelove")"kubectl cluster-info复制代码
上面通过 --config
将我们的配置文件传递给 Kind 用于搭建集群,推荐国内用户使用这种方式。
搭建高可用集群
Kind 也支持搭建高可用的 K8S 集群,不过只能通过配置文件来实现。可以直接将下面的内容保存至文件中,再将配置文件传递给 Kind 即可。
e.g.
kind: ClusterapiVersion: kind.sigs.k8s.io/v1alpha3kubeadmConfigPatches:- | apiVersion: kubeadm.k8s.io/v1beta1 kind: ClusterConfiguration metadata: name: config networking: serviceSubnet: 10.0.0.0/16 imageRepository: registry.aliyuncs.com/google_containers nodeRegistration: kubeletExtraArgs: pod-infra-container-image: registry.aliyuncs.com/google_containers/pause:3.1- | apiVersion: kubeadm.k8s.io/v1beta1 kind: InitConfiguration metadata: name: config networking: serviceSubnet: 10.0.0.0/16 imageRepository: registry.aliyuncs.com/google_containersnodes:- role: control-plane- role: control-plane- role: control-plane- role: worker- role: worker- role: worker复制代码
我们使用以下的命令来搭建高可用的 Kubernetes 集群:
master $ kind create cluster --name moelove-ha --config kind-ha-config.yamlCreating cluster "moelove-ha" ... ✓ Ensuring node image (kindest/node:v1.13.4) ? ✓ Preparing nodes ??????? ✓ Starting the external load balancer ⚖️ ✓ Creating kubeadm config ? ✓ Starting control-plane ?️ ✓ Joining more control-plane nodes ? ✓ Joining worker nodes ?Cluster creation complete. You can now use the cluster with:export KUBECONFIG="$(kind get kubeconfig-path --name="moelove-ha")"kubectl cluster-infomaster $ export KUBECONFIG="$(kind get kubeconfig-path --name="moelove-ha")"master $ kubectl cluster-infoKubernetes master is running at https://localhost:44019KubeDNS is running at https://localhost:44019/api/v1/namespaces/kube-system/services/kube-dns:dns/proxyTo further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.复制代码
可以做下简单的验证:
master $ kubectl get nodesNAME STATUS ROLES AGE VERSIONmoelove-ha-control-plane Ready master 3m42s v1.13.4moelove-ha-control-plane2 Ready master 3m24s v1.13.4moelove-ha-control-plane3 Ready master 2m13s v1.13.4moelove-ha-worker Ready96s v1.13.4moelove-ha-worker2 Ready 98s v1.13.4moelove-ha-worker3 Ready 95s v1.13.4复制代码
可以看到已经成功创建了多 master 的 Kubernetes 集群。
总结
这是使用 Kind 搭建本地 Kubernetes 集群的第一篇,同时本篇的内容也是第 4 节内容的补充,搭配食用效果更佳 :)
可以通过下面二维码订阅我的文章公众号【MoeLove】