[SKIP CI] update readme

This commit is contained in:
Drone Shipper 2019-11-22 23:05:12 +00:00
parent 00c18c72ed
commit d7beb3425e

204
README.md
View File

@ -8,28 +8,28 @@ Role to setup mosquitto mqtt broker
## Table of content ## Table of content
* [Default Variables](#default-variables) * [Default Variables](#default-variables)
* [mosquitto_acl](#mosquitto_acl)
* [mosquitto_acl_enabled](#mosquitto_acl_enabled)
* [mosquitto_acl_file](#mosquitto_acl_file)
* [mosquitto_base_dir](#mosquitto_base_dir) * [mosquitto_base_dir](#mosquitto_base_dir)
* [mosquitto_pid_file](#mosquitto_pid_file)
* [mosquitto_user](#mosquitto_user)
* [mosquitto_group](#mosquitto_group)
* [mosquitto_port](#mosquitto_port)
* [mosquitto_bind_address](#mosquitto_bind_address) * [mosquitto_bind_address](#mosquitto_bind_address)
* [mosquitto_ca_path](#mosquitto_ca_path)
* [mosquitto_group](#mosquitto_group)
* [mosquitto_packages_extra](#mosquitto_packages_extra) * [mosquitto_packages_extra](#mosquitto_packages_extra)
* [mosquitto_persistence_enabled](#mosquitto_persistence_enabled)
* [mosquitto_persistence_path](#mosquitto_persistence_path)
* [mosquitto_password_auth_enabled](#mosquitto_password_auth_enabled) * [mosquitto_password_auth_enabled](#mosquitto_password_auth_enabled)
* [mosquitto_password_auth_file](#mosquitto_password_auth_file) * [mosquitto_password_auth_file](#mosquitto_password_auth_file)
* [mosquitto_password_auth_users](#mosquitto_password_auth_users) * [mosquitto_password_auth_users](#mosquitto_password_auth_users)
* [mosquitto_acl_enabled](#mosquitto_acl_enabled) * [mosquitto_persistence_enabled](#mosquitto_persistence_enabled)
* [mosquitto_acl_file](#mosquitto_acl_file) * [mosquitto_persistence_path](#mosquitto_persistence_path)
* [mosquitto_acl](#mosquitto_acl) * [mosquitto_pid_file](#mosquitto_pid_file)
* [mosquitto_tls_enabled](#mosquitto_tls_enabled) * [mosquitto_port](#mosquitto_port)
* [mosquitto_tls_ciphers](#mosquitto_tls_ciphers)
* [mosquitto_ca_path](#mosquitto_ca_path)
* [mosquitto_tls_cert_source](#mosquitto_tls_cert_source)
* [mosquitto_tls_key_source](#mosquitto_tls_key_source)
* [mosquitto_tls_cert_path](#mosquitto_tls_cert_path) * [mosquitto_tls_cert_path](#mosquitto_tls_cert_path)
* [mosquitto_tls_cert_source](#mosquitto_tls_cert_source)
* [mosquitto_tls_ciphers](#mosquitto_tls_ciphers)
* [mosquitto_tls_enabled](#mosquitto_tls_enabled)
* [mosquitto_tls_key_path](#mosquitto_tls_key_path) * [mosquitto_tls_key_path](#mosquitto_tls_key_path)
* [mosquitto_tls_key_source](#mosquitto_tls_key_source)
* [mosquitto_user](#mosquitto_user)
* [Dependencies](#dependencies) * [Dependencies](#dependencies)
* [License](#license) * [License](#license)
* [Author](#author) * [Author](#author)
@ -38,6 +38,48 @@ Role to setup mosquitto mqtt broker
## Default Variables ## Default Variables
### mosquitto_acl
#### Default value
```YAML
mosquitto_acl: []
```
#### Example usage
```YAML
mosquitto_acl:
- name: iot
user: admin
acls:
- acl_base: topic (topic|pattern, defaults to topic)
acl_topic: ""
acl_policy: readwrite
- name: readonly_iot
user: user1
acls:
- acl_base: topic
acl_topic: my/devices
acl_policy: readwrite
```
### mosquitto_acl_enabled
#### Default value
```YAML
mosquitto_acl_enabled: false
```
### mosquitto_acl_file
#### Default value
```YAML
mosquitto_acl_file: '{{ mosquitto_base_dir }}/aclfile'
```
### mosquitto_base_dir ### mosquitto_base_dir
#### Default value #### Default value
@ -46,38 +88,6 @@ Role to setup mosquitto mqtt broker
mosquitto_base_dir: /etc/mosquitto mosquitto_base_dir: /etc/mosquitto
``` ```
### mosquitto_pid_file
#### Default value
```YAML
mosquitto_pid_file: /var/run/mosquitto.pid
```
### mosquitto_user
#### Default value
```YAML
mosquitto_user: mosquitto
```
### mosquitto_group
#### Default value
```YAML
mosquitto_group: mosquitto
```
### mosquitto_port
#### Default value
```YAML
mosquitto_port: 1883
```
### mosquitto_bind_address ### mosquitto_bind_address
#### Default value #### Default value
@ -86,6 +96,22 @@ mosquitto_port: 1883
mosquitto_bind_address: '{{ ansible_default_ipv4.address }}' mosquitto_bind_address: '{{ ansible_default_ipv4.address }}'
``` ```
### mosquitto_ca_path
#### Default value
```YAML
mosquitto_ca_path: /etc/pki/tls/certs/
```
### mosquitto_group
#### Default value
```YAML
mosquitto_group: mosquitto
```
### mosquitto_packages_extra ### mosquitto_packages_extra
#### Default value #### Default value
@ -94,22 +120,6 @@ mosquitto_bind_address: '{{ ansible_default_ipv4.address }}'
mosquitto_packages_extra: [] mosquitto_packages_extra: []
``` ```
### mosquitto_persistence_enabled
#### Default value
```YAML
mosquitto_persistence_enabled: false
```
### mosquitto_persistence_path
#### Default value
```YAML
mosquitto_persistence_path: /var/lib/mosquitto/mosquitto.db
```
### mosquitto_password_auth_enabled ### mosquitto_password_auth_enabled
#### Default value #### Default value
@ -146,54 +156,52 @@ mosquitto_password_auth_users:
state: absent state: absent
``` ```
### mosquitto_acl_enabled ### mosquitto_persistence_enabled
#### Default value #### Default value
```YAML ```YAML
mosquitto_acl_enabled: false mosquitto_persistence_enabled: false
``` ```
### mosquitto_acl_file ### mosquitto_persistence_path
#### Default value #### Default value
```YAML ```YAML
mosquitto_acl_file: '{{ mosquitto_base_dir }}/aclfile' mosquitto_persistence_path: /var/lib/mosquitto/mosquitto.db
``` ```
### mosquitto_acl ### mosquitto_pid_file
#### Default value #### Default value
```YAML ```YAML
mosquitto_acl: [] mosquitto_pid_file: /var/run/mosquitto.pid
``` ```
#### Example usage ### mosquitto_port
```YAML
mosquitto_acl:
- name: iot
user: admin
acls:
- acl_base: topic (topic|pattern, defaults to topic)
acl_topic: ""
acl_policy: readwrite
- name: readonly_iot
user: user1
acls:
- acl_base: topic
acl_topic: my/devices
acl_policy: readwrite
```
### mosquitto_tls_enabled
#### Default value #### Default value
```YAML ```YAML
mosquitto_tls_enabled: false mosquitto_port: 1883
```
### mosquitto_tls_cert_path
#### Default value
```YAML
mosquitto_tls_cert_path: '{{ mosquitto_base_dir }}/tls/certs/mycert.pem'
```
### mosquitto_tls_cert_source
#### Default value
```YAML
mosquitto_tls_cert_source: mycert.pem
``` ```
### mosquitto_tls_ciphers ### mosquitto_tls_ciphers
@ -211,20 +219,20 @@ mosquitto_tls_ciphers:
- '@STRENGTH' - '@STRENGTH'
``` ```
### mosquitto_ca_path ### mosquitto_tls_enabled
#### Default value #### Default value
```YAML ```YAML
mosquitto_ca_path: /etc/pki/tls/certs/ mosquitto_tls_enabled: false
``` ```
### mosquitto_tls_cert_source ### mosquitto_tls_key_path
#### Default value #### Default value
```YAML ```YAML
mosquitto_tls_cert_source: mycert.pem mosquitto_tls_key_path: '{{ mosquitto_base_dir }}/tls/private/mykey.pem'
``` ```
### mosquitto_tls_key_source ### mosquitto_tls_key_source
@ -235,20 +243,12 @@ mosquitto_tls_cert_source: mycert.pem
mosquitto_tls_key_source: mykey.pem mosquitto_tls_key_source: mykey.pem
``` ```
### mosquitto_tls_cert_path ### mosquitto_user
#### Default value #### Default value
```YAML ```YAML
mosquitto_tls_cert_path: '{{ mosquitto_base_dir }}/tls/certs/mycert.pem' mosquitto_user: mosquitto
```
### mosquitto_tls_key_path
#### Default value
```YAML
mosquitto_tls_key_path: '{{ mosquitto_base_dir }}/tls/private/mykey.pem'
``` ```
## Dependencies ## Dependencies