sansible.vernemq
VerneMQ
Master: 
Develop: 
This role installs and sets up the VerneMQ MQTT message broker, which uses a publish/subscribe model.
Installation and Dependencies
To install, run ansible-galaxy install sansible.vernemq or add this to your roles.yml file.
- name: sansible.vernemq
version: v4.0-latest
Then, execute ansible-galaxy install -p ./roles -r roles.yml.
Tags
This role includes the following tags: build and configure.
build- Installs and starts VerneMQ.configure- Sets up VerneMQ's configuration.
Arguments
| Argument | Default | Description |
|---|---|---|
| sansible_vernemq_cluster_discovery_node | Cluster node to join, in the format nodename@ipaddress. |
|
| sansible_vernemq_configuration | Key-value pairs for configuration options. | |
| sansible_vernemq_download_url | Explicit URL to download VerneMQ Debian package (this cannot be used with the version option). |
|
| sansible_vernemq_nofile | 65536 | Maximum number of open files for the VerneMQ process. |
| sansible_vernemq_version | 1.3.1 | Version of VerneMQ to install (NOTE: The version must be available on the official downloads page). This cannot be used with the download_url option. |
Examples
Install VerneMQ with default settings:
- name: Install VerneMQ
hosts: "somehost"
roles:
- role: sansible.vernemq
Install VerneMQ v1.2.0, set the maximum number of open files to 65536, join a cluster at [email protected], and set the maximum memory percent for LevelDB to 8:
- name: Install VerneMQ
hosts: "somehost"
roles:
- role: sansible.vernemq
sansible_vernemq:
allow_anonymous: "on"
cluster_discovery_node: [email protected]
configuration:
leveldb.maximum_memory.percent: 8
nofile: 65536
version: 1.2.0
All VerneMQ configuration options are supported.
The configuration section can also be used to manage VerneMQ plugins:
- name: Install VerneMQ
hosts: "somehost"
roles:
- role: sansible.vernemq
sansible_vernemq:
configuration:
plugins.vmq_plugin: "on"
Development & Testing
If you want to contribute to this role, start by running make watch; this will run make test whenever a file changes.
ansible-galaxy install sansible.vernemq