产品概览

注意: EMQX Operator 控制器需要 Kubernetes v1.20.0 或者以上。

背景

此教程采用 minikube v1.20.0 安装部署

部署Operator控制器

准备

我们使用 cert manager (opens new window)来给 webhook 服务提供证书。你可以通过 cert manager 文档 (opens new window)来安装。

默认静态安装

安装默认静态配置文件

$ curl -f -L "https://github.com/emqx/emqx-operator/releases/download/1.1.3/emqx-operator-controller.yaml" | kubectl apply -f -

通过 Helm 安装

1. 添加 EMQX Helm 仓库

$ helm repo add emqx https://repos.emqx.io/charts
$ helm repo update

1. 用 Helm 安装 EMQX Operator 控制器

$ helm install emqx-operator emqx/emqx-operator \
   --set installCRDs=true \
   --namespace emqx-operator-system \
   --create-namespace

检查 EMQX Operator 控制器状态

$ kubectl get pods -l "control-plane=controller-manager" -n emqx-operator-system
NAME                                                READY   STATUS    RESTARTS   AGE
emqx-operator-controller-manager-68b866c8bf-kd4g6   1/1     Running   0          15s

部署 EMQX Broker

1. 部署 EMQX Custom Resource

   cat << "EOF" | kubectl apply -f -
   apiVersion: apps.emqx.io/v1beta2
   kind: EmqxBroker
   metadata:
     name: emqx
   spec:
     image: emqx/emqx:4.4.0
   EOF
   

2. 检查 EMQX 状态

   $ kubectl get pods
   NAME              READY   STATUS    RESTARTS   AGE
   emqx-0   1/1     Running   0          22m
   emqx-1   1/1     Running   0          22m
   emqx-2   1/1     Running   0          22m
   
   $ kubectl exec -it emqx-0 -- emqx_ctl status
   Node 'emqx@emqx-0.emqx.default.svc.cluster.local' 4.3.11 is started
   
   $ kubectl exec -it emqx-0 -- emqx_ctl cluster status
   Cluster status: #{running_nodes =>
                         ['emqx@emqx-0.emqx.default.svc.cluster.local',
                          'emqx@emqx-1.emqx.default.svc.cluster.local',
                          'emqx@emqx-2.emqx.default.svc.cluster.local'],
                     stopped_nodes => []}