# Getting Started

Note: EMQX Operator Controller requires Kubernetes v1.20.0 and up.

# Background

This article was deployed using Minikube v1.20.0

# Deployment Operator Controller

This project can be run inside a Kubernetes cluster

# Prepare

We use a cert-manager (opens new window) for provisioning the certificates for the webhook server. You can follow the cert-manager documentation (opens new window) to install it.

# Default static install

You don’t require any tweaking of the EMQX Operator Controller install parameters.

The default static configuration can be installed as follows:

kubectl apply -f "https://github.com/emqx/emqx-operator/releases/download/1.2.4/emqx-operator-controller.yaml"

# Installing with Helm

Add the EMQX Helm repository:

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

1
2

Install EMQX Operator Controller by helm:

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

1
2
3
4

# Check EMQX Operator Controller status

$ 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

1
2
3

# Deploy the EMQX Enterprise

Deploy EMQX Enterprise Custom Resource

cat << "EOF" | kubectl apply -f -
apiVersion: apps.emqx.io/v1beta3
kind: EmqxEnterprise
metadata:
  name: emqx-ee
  labels:
    "foo": "bar"
spec:
  emqxTemplate:
    image: emqx/emqx-ee:4.4.6
EOF

1
2
3
4
5
6
7
8
9
10
11

Check EMQX status

$ kubectl get pods  
NAME              READY   STATUS    RESTARTS   AGE  
emqx-ee-0   2/2     Running   0          22m  
emqx-ee-1   2/2     Running   0          22m  
emqx-ee-2   2/2     Running   0          22m  

$ kubectl exec -it emqx-ee-0 -c emqx -- emqx_ctl status  
Node 'emqx-ee@emqx-ee-0.emqx-ee-headless.default.svc.cluster.local' 4.4.5 is started  

$ kubectl exec -it emqx-ee-0 -c emqx -- emqx_ctl cluster status  
Cluster status: #{running_nodes =>
                   ['emqx-ee@emqx-ee-0.emqx-ee-headless.default.svc.cluster.local',
                    'emqx-ee@emqx-ee-1.emqx-ee-headless.default.svc.cluster.local',
                    'emqx-ee@emqx-ee-2.emqx-ee-headless.default.svc.cluster.local'],
               stopped_nodes => []}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Deploy the EMQX Broker

Deploy EMQX Broker Custom Resource

cat << "EOF" | kubectl apply -f -
apiVersion: apps.emqx.io/v1beta3
kind: EmqxBroker
metadata:
  name: emqx
  labels:
    "foo": "bar"
spec:
  emqxTemplate:
    image: emqx/emqx:4.4.6
EOF

1
2
3
4
5
6
7
8
9
10
11

Check EMQX status

$ kubectl get pods
NAME              READY   STATUS    RESTARTS   AGE
emqx-0   2/2     Running   0          22m
emqx-1   2/2     Running   0          22m
emqx-2   2/2     Running   0          22m

$ kubectl exec -it emqx-0 -c emqx -- emqx_ctl status
Node 'emqx@emqx-0.emqx-headless.default.svc.cluster.local' 4.4.5 is started

$ kubectl exec -it emqx-0 -c emqx -- emqx_ctl cluster status
Cluster status: #{running_nodes =>
                   ['emqx@emqx-0.emqx-headless.default.svc.cluster.local',
                    'emqx@emqx-1.emqx-headless.default.svc.cluster.local',
                    'emqx@emqx-2.emqx-headless.default.svc.cluster.local'],
               stopped_nodes => []}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

← Deployment Install EMQX plugin →