https://github.com/amirhnajafiz/distributed-emqx

An example of EMQX distributed deployment with Nginx.
https://github.com/amirhnajafiz/distributed-emqx

emq emqx go golang nginx nginx-proxy

Last synced: 3 days ago
JSON representation

An example of EMQX distributed deployment with Nginx.

• Host: GitHub
• URL: https://github.com/amirhnajafiz/distributed-emqx
• Owner: amirhnajafiz
• Created: 2023-11-24T15:49:01.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2024-03-18T07:33:27.000Z (9 months ago)
• Last Synced: 2024-12-16T22:03:03.061Z (6 days ago)
• Topics: emq, emqx, go, golang, nginx, nginx-proxy
• Language: Go
• Homepage:
• Size: 93.8 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# EMQX

This is an example for using distributed ```EMQX```.

In this example, we are building our cluster using **docker**. At first, we setup a ```EMQX``` cluster with 3 nodes. When the whole cluster is up and running, we are going to use ```Nginx``` as a

load balancer to manage the input traffic that is being transmitted to cluster nodes.

In order to test the cluster validation, we setup a BlackBox exporter. We are using ```mqtt.go``` library to test the cluster by publishing events and subscribing over a topic.

## Setup

Use the following docker-compose command in order to bring up the whole example.

```sh

docker-compose -f emqx/docker-compose.yml up -d

```

After that you should have the three following containers:

- emqx-cluster-1-container, emqx-cluster-2-container, emqx-cluster-3-container

- nginx-container

- emqx-client-container (blackbox)

> NOTE: In order to stop the containers use the following command:

> ```docker-compose -f emqx/docker-compose.yml down```

## Logs

If you inspect the client-container logs, you can see that the whole cluster is responding:

```shell

emqx[client]   enter Publish

emqx[client]   sending publish message, topic: rides

emqx[net]      obound msg to write 0

emqx[net]      obound wrote msg, id: 0

emqx[net]      outgoing waiting for an outbound message

2024/03/11 08:46:44 topic:rides

new-ride

emqx[net]      startIncoming Received Message

emqx[net]      startIncomingComms: got msg on ibound

emqx[net]      startIncomingComms: received publish, msgId: 0

emqx[net]      logic waiting for msg on ibound

emqx[client]   enter Publish

emqx[client]   sending publish message, topic: rides

emqx[net]      obound msg to write 0

emqx[net]      obound wrote msg, id: 0

emqx[net]      outgoing waiting for an outbound message

2024/03/11 08:46:44 topic:rides

new-ride

```