vernemq

Master:
Develop:

• Installation and Dependencies
• Tags
• Examples

This role installs and configures the VerneMQ MQTT publish/subscribe message broker.

Installation and Dependencies

To install run ansible-galaxy install sansible.vernemq or add this to your roles.yml.

- name: sansible.vernemq
  version: v4.0-latest

and run ansible-galaxy install -p ./roles -r roles.yml

Tags

This role uses tags: build and configure

• build - Installs and starts VerneMQ
• configure - Configures VerneMQ

Arguments

Argument	Default	Description
sansible_vernemq_cluster_discovery_node		Cluster node to join in nodename@ipaddress format
sansible_vernemq_configuration		key: value configuration option pairs
sansible_vernemq_download_url		Explicit URL from which to download VerneMQ Debian package mutually exclusive with the version option
sansible_vernemq_nofile	65536	Max number of open files for the VerneMQ process
sansible_vernemq_version	1.3.1	Version of VerneMQ to be installed (NOTE: Version has to be available from the official VerneMQ downloads page) mutually exclusive with the download_url option

Examples

Install VerneMQ stable with default configuration:

- name: Install VerneMQ
  hosts: "somehost"

  roles:
    - role: sansible.vernemq

Install VerneMQ v1.2.0, set the number of open maximum open files (nofiles) to 65536, join a cluster via [email protected], and the leveldb.maximum_memory.percent configuration option 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 is also the place 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 work on this role, please start with running make watch; this will execute make test on any file change.