在树莓派上通过K3S部署EMQ-X-edge集群

环境

k3s 需要 raspberrypi 可以正常访问 google，如果没有条件的话推荐在 AWS 上尝试部署。

Hostname	IP	角色	硬件
raspberrypi	192.168.1.99	server	树莓派 3
emqx1	192.168.1.100	agent	树莓派 3
emqx2	192.168.1.101	agent	树莓派 3

准备

在树莓派上部署 k3s 集群

1. 下载 k3s，k3s 支持 x86_64，armhf 和 arm64，树莓派上应该安装 armhf

$ wget https://github.com/rancher/k3s/releases/download/v0.2.0/k3s-armhf
$ mv k3s-armhf /usr/local/bin/k3s
$ chmod +x /usr/local/bin/k3s

2. 启动 Server

$ sudo k3s server

3. 加入集群

a. 在 Server 节点上查看 /var/lib/rancher/k3s/server/node-token 获取 node token

$ NODE_TOKEN=$(sudo cat /var/lib/rancher/k3s/server/node-token)

b. 在 agent 节点上执行 sudo k3s agent --server https://192.168.1.99:6443 --token ${NODE_TOKEN} 加入 k3s 集群。

4.（可选）外部设备使用 kubectl 管理 k3s 集群

a. 选取任意能与集群通信并安装了kubectl 的外部设备

b. 拷贝 /etc/rancher/k3s/k3s.yaml 文件到外部设备的 ~/.kube/config

c. 修改 ~/.kube/config，将 https://localhost:6443 替换为https://192.168.1.99:6443

d. 使用 kubectl 管理集群

$ kubectl get nodes
NAME         STATUS  ROLES  AGE  VERSION
emqx2        Ready   <none>  29m  v1.13.4-k3s.1
emqx1         Ready   <none>  29m  v1.13.4-k3s.1
raspberrypi Ready   <none>  31m   v1.13.4-k3s.1

安装 HELM

安装 helm 客户端

• 通过访问：https://github.com/kubernetes…。下载 Helm 的合适的版本。

  1. 此文下载 helm-v2.8.0-linux-amd64.tgz 版本；

  2. 解压缩文件：tar -zxvf helm-v2.8.0-linux-amd64.tgz

  3. 将解压缩后的 helm 移至/usr/local/bin 目录下：mv linux-amd64/helm /usr/local/bin/helm

  注意：

  最好在安装 kubectl 命令行工具的机器上安装 Helm 客户端；或者将安装kubectl 命令行工具生成的配置文件（$HOME/.kube/config）复制到 Helm 客户端所安装的机器上($HOME/.kube/config )。

安装 Tiller 服务器

创建一个名为 tiller 的 Service Account

$ kubectl create serviceaccount tiller --namespace kube-system

授予名为 tiller 的 Service Account 集群管理员角色 cluster-admin:

• 将 tiller 绑定至集群管理员角色的的 yaml 文件如下所示：

$ cat <<EOF >rbac-config.yaml
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
name: tiller
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: cluster-admin
subjects:
- kind: ServiceAccount
name: tiller
namespace: kube-system
EOF

• 通过执行 kubectl create -f将授予 tiller 集群管理员角色：

$ kubectl create -f rbac-config.yaml

安装 Tiller 服务器

$ helm init --service-account tiller

验证安装

在安装完成后，可以通过执行如下命令来检查是安装成功：

$ helm version 

如果正确显示 Helm 客户端和 Tiller 服务器的版本，这表示安装成功。

或者通过执行 kubectl 的如下命令来查看是否已正常按照 Tiller 服务器：

$ kubectl get pods -n kube-system 

部署 EMQX 集群

1. 通过 Helm 部署 EMQX

$ git clone https://github.com/emqx/emqx-chart $ cd emqx-chart $ helm install --name myemqx --set deployment.image="emqx/emqx-edge:latest" . 

关于此仓库更多的设置，请查看 README

2. 查看 EMQX 的集群状态

a. 查看 pods 列表

$ kubectl get pods |grep myemqx myemqx-emqx-chart-54974fc5f5-v8chq           1/1     Running   0          2m9s myemqx-emqx-chart-54974fc5f5-zz9gc           1/1     Running   0          2m9s 

b. 使用 emqx_ctl cluster status 查看集群状态

$ kubectl exec myemqx-emqx-chart-54974fc5f5-v8chq /opt/emqx/bin/emqx_ctl cluster status Cluster status: [{running_nodes,['emqx@10.42.2.11','emqx@10.42.1.15']}]

---

更多信息请访问我们的官网 emqx.io，或关注我们的开源项目 github.com/emqx/emqx，详细文档请访问 官方文档。