https://github.com/antoinegagne/mqtt-simulator

Simulate MQTT devices
https://github.com/antoinegagne/mqtt-simulator

docker erlang mqtt mqtt-simulator simulator

Last synced: 3 days ago
JSON representation

Simulate MQTT devices

• Host: GitHub
• URL: https://github.com/antoinegagne/mqtt-simulator
• Owner: AntoineGagne
• License: other
• Created: 2019-05-23T00:00:30.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-10-30T14:07:12.000Z (about 5 years ago)
• Last Synced: 2024-11-02T13:33:46.109Z (about 2 months ago)
• Topics: docker, erlang, mqtt, mqtt-simulator, simulator
• Language: Erlang
• Homepage:
• Size: 40 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
==============

mqtt-simulator

==============

.. image:: https://travis-ci.org/AntoineGagne/mqtt-simulator.svg?branch=master

    :target: https://travis-ci.org/AntoineGagne/mqtt-simulator

.. image:: https://ci.appveyor.com/api/projects/status/glyeekdu4vum33ht/branch/master?svg=true

    :target: https://ci.appveyor.com/api/projects/status/glyeekdu4vum33ht/branch/master

:Author: `Antoine Gagné `_

.. contents::

    :backlinks: none

.. sectnum::

Installation

============

Local Build

-----------

To build the runnable release, you need to have Erlang with OTP 21 and above.

You also need ``rebar3``. Then, you can run the following command:

.. code-block:: sh

    rebar3 as prod release

Docker Image

------------

To build this image, you can use the following command:

.. code-block:: sh

    docker build -f Dockerfile -t "${name_of_the_image}" .

Usage

=====

From Local Build

----------------

If you built the release, you can run it with:

.. code-block:: sh

    ./_build/prod/rel/mqtt_simulator/bin/mqtt_simulator foreground

Docker

------

After building the image, you can run the image by using the following command:

.. code-block:: sh

    docker run \

        --detach \

        --name "${name_of_the_running_container}" \

        --publish "${port_on_host}:${port_of_simulator:-8000}" \

        "${name_of_the_image}"

Development

===========

Running all the tests and linters

---------------------------------

You can run all the tests and linters with the ``rebar3`` alias:

.. code-block:: sh

    rebar3 check