1. Prerequisites:

• kubectl

• jq

• envsubst (brew install gettext on OSX)

• K8s :

  • KIND + Docker (Resources: 8 CPU / 8 GB RAM)

2. Quick Start

   To build images, you can open the network.sh file and modify _IMAGE_NAME and IMAGE_VERSION to change the image tags.

    cd example/test-network-k8s
    ./network.sh build-images

   Pull some necessary images

    docker pull k8s.gcr.io/ingress-nginx/controller:v1.1.2
    docker pull quay.io/jetstack/cert-manager-webhook:v1.6.1
    docker pull quay.io/jetstack/cert-manager-controller:v1.6.1
    docker pull quay.io/jetstack/cert-manager-cainjector:v1.6.1
    docker pull k8s.gcr.io/ingress-nginx/kube-webhook-certgen:v1.1.1

   Initialize the KIND cluster

    ./network.sh kind

   Load images into the KIND cluster

    ./network.sh kind-load-images

   Launch the KIND Kubernetes cluster

    ./network.sh cluster-init

   Start the RobustMQ cluster

    ./network.sh up

3. Cleanup

    ./network.sh unkind

4. Review the Process

   • Install KIND
   • Pull some necessary images
   • Initialize the KIND cluster
   • Load images into the KIND cluster
   • Launch the KIND Kubernetes cluster
   • Start the RobustMQ cluster

5. Verify that MQTT functions correctly

This KIND-Kubernetes cluster will start a cli-command pod, from which you can execute cli-command commands within the pod.

First, get the name of the cli-command pod

% kubectl get pods -n robustmq
NAME                                READY   STATUS    RESTARTS   AGE
cli-command-6fbf8b6cc-7ldqp          1/1     Running   0          16m

Then, enter the cli-command pod and run commands

Publish messages

% kubectl exec -it cli-command-6fbf8b6cc-7ldqp -n robustmq -- /bin/sh
# ./cli-command mqtt --server=mqtt-server-cs.robustmq.svc.cluster.local:1883 publish --username=admin --password=pwd123 --topic=test/topic1 --qos=0
able to connect: "mqtt-server-cs.robustmq.svc.cluster.local:1883"
you can post a message on the terminal:
1
> You typed: 1
2
> You typed: 2
3
> You typed: 3
^C>  Ctrl+C detected,  Please press ENTER to end the program.

Subscribe to messages

kubectl exec -it cli-command-6fbf8b6cc-7ldqp -n robustmq -- /bin/sh
# cd libs
# ./cli-command mqtt --server=mqtt-server-cs.robustmq.svc.cluster.local:1883  subscribe --username=admin --password=pwd123 --topic=test/topic1 --qos=0
able to connect: "mqtt-server-cs.robustmq.svc.cluster.local:1883"
subscribe success
payload: 1
payload: 2
payload: 3
^C Ctrl+C detected,  Please press ENTER to end the program.
End of input stream.

For more commands, please refer to cli-command

Check the documentation to run the test：MQTT functional tests