cdist−type__consul_template − Manage the consul−template service
Downloads and installs the consul−template binary from https://github.com/hashicorp/consul−template/releases/download/. Generates a global config file and creates directory for per template config files. Note that the consul−template binary is downloaded on the server (the machine running cdist) and then deployed to the target host using the __file type.
None.
auth−username
specify a username for basic authentication.
auth−password
specify a password for basic authentication.
batch−size
the size of the batch when polling multiple dependencies.
consul |
the location of the Consul instance to query (may be an IP address or FQDN) with port. Defaults to 'localhost:8500'. |
log−level
The log level for output. This applies to the stdout/stderr logging as well as syslog logging (if enabled). Valid values are "debug", "info", "warn", and "err". The default value is "warn".
max−stale
the maximum staleness of a query. If specified, Consul will distribute work among all servers instead of just the leader.
retry |
the amount of time to wait if Consul returns an error when communicating with the API. |
||
state |
either 'present' or 'absent'. Defaults to 'present' |
ssl−cert
Path to an SSL client certificate to use to authenticate to the consul server. Useful if the consul server "verify_incoming" option is set.
ssl−ca−cert
Path to a CA certificate file, containing one or more CA certificates to use to validate the certificate sent by the consul server to us. This is a handy alternative to setting −−ssl−no−verify if you are using your own CA.
syslog−facility
The facility to use when sending to syslog. This requires the use of −−syslog. The default value is LOCAL0.
token |
the Consul API token. |
vault−address
the location of the Vault instance to query (may be an IP address or FQDN) with port.
vault−token
the Vault API token.
vault−ssl−cert
Path to an SSL client certificate to use to authenticate to the vault server.
vault−ssl−ca−cert
Path to a CA certificate file, containing one or more CA certificates to use to validate the certificate sent by the vault server to us.
version
which version of consul−template to install. See ./files/versions for a list of supported versions. Defaults to the latest known version.
wait |
the minimum(:maximum) to wait before rendering a new template to disk and triggering a command, separated by a colon (:). If the optional maximum value is omitted, it is assumed to be 4x the required minimum value. |
ssl |
use HTTPS while talking to Consul. Requires the Consul server to be configured to serve secure connections. |
ssl−no−verify
ignore certificate warnings. Only used if ssl is enabled.
syslog |
Send log output to syslog (in addition to stdout and stderr). |
vault−ssl
use HTTPS while talking to Vault. Requires the Vault server to be configured to serve secure connections.
vault−ssl−no−verify
ignore certificate warnings. Only used if vault is enabled.
__consul_template \ −−consul consul.service.consul:8500 \ −−retry 30s # specific version __consul_template \ −−version 0.6.5 \ −−retry 30s
consul documentation at: <- https://github.com/hashicorp/consul−template>.
Steven Armstrong <steven−cdist−−@−−armstrong.cc>
Copyright (C) 2015 Steven Armstrong. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.