Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/voxpupuli/puppet-mosquitto

Puppet module to manage Eclipse Mosquitto
https://github.com/voxpupuli/puppet-mosquitto

archlinux-puppet-module bsd-puppet-module centos-puppet-module debian-puppet-module fedora-puppet-module freebsd-puppet-module hacktoberfest linux-puppet-module puppet redhat-puppet-module ubuntu-puppet-module

Last synced: about 1 month ago
JSON representation

Puppet module to manage Eclipse Mosquitto

Awesome Lists containing this project

README

        

# Mosquitto module for Puppet

[![Build Status](https://github.com/voxpupuli/puppet-mosquitto/workflows/CI/badge.svg)](https://github.com/voxpupuli/puppet-mosquitto/actions?query=workflow%3ACI)
[![Release](https://github.com/voxpupuli/puppet-mosquitto/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/puppet-mosquitto/actions/workflows/release.yml)
[![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/mosquitto.svg)](https://forge.puppetlabs.com/puppet/mosquitto)
[![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/mosquitto.svg)](https://forge.puppetlabs.com/puppet/mosquitto)
[![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/mosquitto.svg)](https://forge.puppetlabs.com/puppet/mosquitto)
[![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/mosquitto.svg)](https://forge.puppetlabs.com/puppet/mosquitto)
[![puppetmodule.info docs](http://www.puppetmodule.info/images/badge.png)](http://www.puppetmodule.info/m/puppet-mosquitto)
[![AGPL v3 License](https://img.shields.io/github/license/voxpupuli/puppet-mosquitto.svg)](LICENSE)

## ToC

* [Description](#description)
* [License](#license)
* [Development and Contribution](#development-and-contribution)
* [Authors](#authors)

## Description

This module configures the [Eclipse mosquitto](https://mosquitto.org/) service. This is an open source (EPL/EDL licensed) message broker that implements the MQTT protocol.

The default configuration allows anonymous access. It works simply with:

```puppet
include mosquitto
```

All parameters are documented in the REFERENCE.md. You can pass configuration options with:

```puppet
class { 'mosquitto':
config => [
'acl_file foobar.acl',
'bridge_insecure false',
],
}
```

## License

This project is licensed under AGPL-3. A license file is in the document root of this repository.

## Development and Contribution

This project contains tests for [rspec-puppet](http://rspec-puppet.com/).

Quickstart to run all linter and unit tests:

```bash
bundle install --path .vendor/ --without system_tests --without development --without release
bundle exec rake test
```

Detailed information about the test setup and contributions are in the CONTRIBUTING.md in the `.github/` directory.

## Authors

puppet-mosquitto is maintained by [Vox Pupuli](https://voxpupuli.org), it was written by [Tim 'bastelfreak' Meusel](https://github.com/bastelfreak).