magistrala/docker

Docker Composition

Configure environment variables and run SuperMQ Docker Composition.

*Note**: docker-compose uses .env file to set all environment variables. Ensure that you run the command from the same location as .env file.

Installation

Follow the official documentation.

Usage

Run the following commands from the project root directory.

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

docker compose -f docker/addons/<path>/docker-compose.yml up

To pull docker images from a specific release you need to change the value of SMQ_RELEASE_TAG in .env before running these commands.

Broker Configuration

SuperMQ supports configurable MQTT broker and Message broker, which also acts as an events store. SuperMQ uses two types of brokers:

1. MQTT_BROKER: Handles MQTT communication between MQTT adapters and message broker. This is NATS.
2. MESSAGE_BROKER: Manages message exchange between SuperMQ core, optional, and external services. This can either be 'NATS' or 'RabbitMQ'. This is used to store messages for distributed processing.

Events store: This is used by SuperMQ services to store events for distributed processing. SuperMQ uses a single service to be the message broker and events store. This can either be 'NATS' or 'RabbitMQ'. Redis can also be used as an events store, but it requires a message broker to be deployed along with it for message exchange.

This is the same as MESSAGE_BROKER. This can either be 'NATS' or 'RabbitMQ' or 'Redis'. If Redis is used as an events store, then RabbitMQ or NATS is used as a message broker.

The current deployment strategy for SuperMQ in docker/docker-compose.yml is to use NATS as a MQTT_BROKER, MESSAGE_BROKER and EVENTS_STORE.

Therefore, the following combinations are possible:

• MESSAGE_BROKER: RabbitMQ, EVENTS_STORE: RabbitMQ
• MESSAGE_BROKER: RabbitMQ, EVENTS_STORE: Redis
• MESSAGE_BROKER: NATS, EVENTS_STORE: NATS
• MESSAGE_BROKER: NATS, EVENTS_STORE: Redis

For Message brokers other than NATS, you would need to build the docker images with RabbitMQ as the build tag and change the docker/.env. For example, to use RabbitMQ as a message broker:

SMQ_MESSAGE_BROKER_TYPE=rabbitmq make dockers

SMQ_MESSAGE_BROKER_TYPE=rabbitmq
SMQ_MESSAGE_BROKER_URL=${SMQ_RABBITMQ_URL}

For Redis as an events store, you would need to run RabbitMQ or NATS as a message broker. For example, to use Redis as an events store with rabbitmq as a message broker:

SMQ_ES_TYPE=redis SMQ_MESSAGE_BROKER_TYPE=rabbitmq make dockers

SMQ_MESSAGE_BROKER_TYPE=rabbitmq
SMQ_MESSAGE_BROKER_URL=${SMQ_RABBITMQ_URL}
SMQ_ES_TYPE=redis
SMQ_ES_URL=${SMQ_REDIS_URL}

RabbitMQ configuration

services:
  rabbitmq:
    image: rabbitmq:3.12.12-management-alpine
    container_name: supermq-rabbitmq
    restart: on-failure
    environment:
      RABBITMQ_ERLANG_COOKIE: ${SMQ_RABBITMQ_COOKIE}
      RABBITMQ_DEFAULT_USER: ${SMQ_RABBITMQ_USER}
      RABBITMQ_DEFAULT_PASS: ${SMQ_RABBITMQ_PASS}
      RABBITMQ_DEFAULT_VHOST: ${SMQ_RABBITMQ_VHOST}
    ports:
      - ${SMQ_RABBITMQ_PORT}:${SMQ_RABBITMQ_PORT}
      - ${SMQ_RABBITMQ_HTTP_PORT}:${SMQ_RABBITMQ_HTTP_PORT}
    networks:
      - supermq-base-net

Redis configuration

services:
  redis:
    image: redis:7.2.4-alpine
    container_name: supermq-es-redis
    restart: on-failure
    networks:
      - supermq-base-net
    volumes:
      - supermq-broker-volume:/data

Nginx Configuration

Nginx is the entry point for all traffic to SuperMQ. By using environment variables file at docker/.env you can modify the below given Nginx directive.

SMQ_NGINX_SERVER_NAME environmental variable is used to configure nginx directive server_name. If environmental variable SMQ_NGINX_SERVER_NAME is empty then default value localhost will set to server_name.

SMQ_NGINX_SERVER_CERT environmental variable is used to configure nginx directive ssl_certificate. If environmental variable SMQ_NGINX_SERVER_CERT is empty then by default server certificate in the path docker/ssl/certs/supermq-server.crt will be assigned.

SMQ_NGINX_SERVER_KEY environmental variable is used to configure nginx directive ssl_certificate_key. If environmental variable SMQ_NGINX_SERVER_KEY is empty then by default server certificate key in the path docker/ssl/certs/supermq-server.key will be assigned.

SMQ_NGINX_SERVER_CLIENT_CA environmental variable is used to configure nginx directive ssl_client_certificate. If environmental variable SMQ_NGINX_SERVER_CLIENT_CA is empty then by default certificate in the path docker/ssl/certs/ca.crt will be assigned.

SMQ_NGINX_SERVER_DHPARAM environmental variable is used to configure nginx directive ssl_dhparam. If environmental variable SMQ_NGINX_SERVER_DHPARAM is empty then by default file in the path docker/ssl/dhparam.pem will be assigned.