2015-02-24 12:10:17 +00:00
|
|
|
cdist-type__consul_template(7)
|
|
|
|
==============================
|
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
cdist-type__consul_template - manage the consul-template service
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2015-02-24 22:59:06 +00:00
|
|
|
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.
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2015-05-28 20:26:51 +00:00
|
|
|
auth-username::
|
|
|
|
specify a username for basic authentication.
|
|
|
|
auth-password::
|
|
|
|
specify a password for basic authentication.
|
2015-02-24 12:10:17 +00:00
|
|
|
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'.
|
2015-05-28 20:26:51 +00:00
|
|
|
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".
|
2015-02-24 12:10:17 +00:00
|
|
|
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.
|
2015-02-24 22:59:06 +00:00
|
|
|
state::
|
|
|
|
either 'present' or 'absent'. Defaults to 'present'
|
2015-05-28 20:26:51 +00:00
|
|
|
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.
|
2015-02-24 12:10:17 +00:00
|
|
|
token::
|
|
|
|
the Consul API token.
|
2015-02-24 22:59:06 +00:00
|
|
|
version::
|
|
|
|
which version of consul-template to install. See ./files/versions for a list of
|
|
|
|
supported versions. Defaults to the latest known version.
|
2015-02-24 12:10:17 +00:00
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
------------------
|
|
|
|
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.
|
2015-05-28 20:26:51 +00:00
|
|
|
syslog::
|
|
|
|
Send log output to syslog (in addition to stdout and stderr).
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
__consul_template \
|
|
|
|
--consul consul.service.consul:8500 \
|
|
|
|
--retry 30s
|
2015-02-24 22:59:06 +00:00
|
|
|
|
|
|
|
# specific version
|
|
|
|
__consul_template \
|
|
|
|
--version 0.6.5 \
|
|
|
|
--retry 30s
|
2015-02-24 12:10:17 +00:00
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
- cdist-type(7)
|
|
|
|
- https://github.com/hashicorp/consul-template
|
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
-------
|
|
|
|
Copyright \(C) 2015 Steven Armstrong. Free use of this software is
|
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|