Updated readme to document all parameters the main manifest accepts

This commit is contained in:
Vik Bhatti 2015-06-22 17:11:40 +01:00
Родитель 36df03905a
Коммит 6e33c6720f
1 изменённых файлов: 39 добавлений и 2 удалений

Просмотреть файл

@ -9,12 +9,49 @@
* Installs a configuration file (/etc/consul-template/config.json)
* Manages the consul-template service via upstart, sysv, or systemd
##Parameters
- `purge_config_dir` **Default**: true. If enabled, removes config files no longer managed by Puppet.
- `bin_dir` **Default**: /usr/local/bin. Path to the consul-template binaries
- `arch` **Default**: Read from facter. System architecture to use (amd64, x86_64, i386)
- `version` **Default**: 0.6.0. Version of consul-template to install
- `install_method` **Default**: url. When set to 'url', consul-template is downloaded and installed from source. If
set to 'package', its installed using the system package manager.
- `os` **Default**: Read from facter.
- `download_url` **Default**: https://github.com/hashicorp/consul-template/releases/download/v${version}/consul-template_${version}_${os}_${arch}.tar.gz. URL to download consul-template from (when `install_method` is set to 'url')
- `package_name` **Default**: consul-template. Name of package to install
- `package_ensure` **Default**: latest.
- `config_dir` **Default**: /etc/consul-template. Path to store the consul-template configuration
- `extra_options` Default: ''. Extra options to be bassed to the consul-template agent. See https://github.com/hashicorp/consul-template#options
- `service_enable` Default: true.
- `service_ensure` Default: running.
- `consul_host` Default: localhost. Hostanme of consul agent to query
- `consul_port` Default: 8500. Port number the API is running on
- `consul_token` Default: ''. ACL token to use when querying consul
- `consul_retry` Default: 10s. Time in seconds to wait before retrying consul requests
- `init_style` Init style to use for consul-template service.
- `log_level` Default: info. Logging level to use for consul-template service. Can be 'debug', 'warn', 'err', 'info'
##Usage
The simplest way to use this module is:
```puppet
include consul_template
```
Or to specify parameters:
```puppet
class { 'consul_template':
service_enable => false
log_level => 'debug',
init_style => 'upstart'
}
```
## Watch files
To declare a file that you wish to populate from Consul key-values, you use the
@ -36,6 +73,6 @@ Depends on the JSON gem, or a modern ruby.
##Development
See the [contributing guide](CONTRIBUTING.md)
Open an [issue](https://github.com/gdhbashton/puppet-consul_template/issues) or
[fork](https://github.com/gdhbashton/puppet-consul_template/fork) and open a
Open an [issue](https://github.com/gdhbashton/puppet-consul_template/issues) or
[fork](https://github.com/gdhbashton/puppet-consul_template/fork) and open a
[Pull Request](https://github.com/gdhbashton/puppet-consul_template/pulls)