ansible-mosquitto

Mosquitto™ is an open source (EPL/EDL licensed) message broker that implements the MQTT protocol versions 3.1 and 3.1.1. MQTT provides a lightweight method of carrying out messaging using a publish/subscribe model. This makes it suitable for "Internet of Things" messaging such as with low power sensors or mobile devices such as phones, embedded computers or microcontrollers like the Arduino.

More information about Mosquitto can be found here: https://mosquitto.org/

This role installs Mosquitto on the target server using the apt-get package manager. It works for Ubuntu and Debian servers and was tested with the help of docker containers. In comparison to other Ansible role tests where Ansible runs inside the container and is connecting to localhost, I decided to use the Ansible docker connection (ansible_connection=docker). The build which run at Travis CI uses this functionality.

See also:

• GitHub project with Dockerfiles: https://github.com/pbonrad/ansible-docker-base
• Role on Ansible Galaxy: https://galaxy.ansible.com/pbonrad/mosquitto/

Role Variables

A complete configuration file (which is quite long) can be found on the GitHub project: https://github.com/eclipse/mosquitto/blob/master/mosquitto.conf

Actually I decided to use only a very limited number of basic configuration options to use in this role. The chosen entries are exact the same as are set while a default installation. I will extend it as soon as I or someone else needs more options.

Dependencies

There are no dependencies to other roles. If you want to run the test, you need to install Docker.

Example Playbook

An example playbook is included in the test.yml file. You can use run.sh for running a test locally, which starts a docker container as the target.

- hosts: all
  roles:
     - role: ansible-mosquitto

Contributions and Feedback

Any contributions are welcome. For any bugs or feature requests, please open an issue through Github.

License

MIT

Author Information

Peter Bonrad - pbonrad - 2016