2015-02-24 12:10:17 +00:00
|
|
|
cdist-type__consul_template(7)
|
|
|
|
==============================
|
2016-06-23 14:08:59 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
cdist-type__consul_template - Manage the consul-template service
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
auth-username
|
2015-05-28 20:26:51 +00:00
|
|
|
specify a username for basic authentication.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
auth-password
|
2015-05-28 20:26:51 +00:00
|
|
|
specify a password for basic authentication.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
batch-size
|
2015-02-24 12:10:17 +00:00
|
|
|
the size of the batch when polling multiple dependencies.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
consul
|
2015-02-24 12:10:17 +00:00
|
|
|
the location of the Consul instance to query (may be an IP address or FQDN) with port.
|
|
|
|
Defaults to 'localhost:8500'.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
log-level
|
2015-05-28 20:26:51 +00:00
|
|
|
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".
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
max-stale
|
2015-02-24 12:10:17 +00:00
|
|
|
the maximum staleness of a query. If specified, Consul will distribute work among all
|
|
|
|
servers instead of just the leader.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
retry
|
2015-02-24 12:10:17 +00:00
|
|
|
the amount of time to wait if Consul returns an error when communicating
|
|
|
|
with the API.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
state
|
2015-02-24 22:59:06 +00:00
|
|
|
either 'present' or 'absent'. Defaults to 'present'
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
ssl-cert
|
2015-05-28 20:26:51 +00:00
|
|
|
Path to an SSL client certificate to use to authenticate to the consul server.
|
|
|
|
Useful if the consul server "verify_incoming" option is set.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
ssl-ca-cert
|
2015-05-28 20:26:51 +00:00
|
|
|
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.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
syslog-facility
|
2015-05-28 20:26:51 +00:00
|
|
|
The facility to use when sending to syslog. This requires the use of --syslog.
|
|
|
|
The default value is LOCAL0.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
token
|
2015-02-24 12:10:17 +00:00
|
|
|
the Consul API token.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-address
|
2015-07-23 22:21:08 +00:00
|
|
|
the location of the Vault instance to query (may be an IP address or FQDN) with port.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-token
|
2015-07-23 22:21:08 +00:00
|
|
|
the Vault API token.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-ssl-cert
|
2015-07-23 22:21:08 +00:00
|
|
|
Path to an SSL client certificate to use to authenticate to the vault server.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-ssl-ca-cert
|
2015-07-23 22:21:08 +00:00
|
|
|
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.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
version
|
2015-02-24 22:59:06 +00:00
|
|
|
which version of consul-template to install. See ./files/versions for a list of
|
|
|
|
supported versions. Defaults to the latest known version.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
wait
|
2015-02-24 12:10:17 +00:00
|
|
|
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
|
|
|
|
------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
ssl
|
2015-02-24 12:10:17 +00:00
|
|
|
use HTTPS while talking to Consul. Requires the Consul server to be configured to serve secure connections.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
ssl-no-verify
|
2015-02-24 12:10:17 +00:00
|
|
|
ignore certificate warnings. Only used if ssl is enabled.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
syslog
|
2015-05-28 20:26:51 +00:00
|
|
|
Send log output to syslog (in addition to stdout and stderr).
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-ssl
|
2015-07-23 22:21:08 +00:00
|
|
|
use HTTPS while talking to Vault. Requires the Vault server to be configured to serve secure connections.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
vault-ssl-no-verify
|
2015-07-23 22:21:08 +00:00
|
|
|
ignore certificate warnings. Only used if vault is enabled.
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
__consul_template \
|
|
|
|
--consul consul.service.consul:8500 \
|
|
|
|
--retry 30s
|
2015-02-24 22:59:06 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# specific version
|
|
|
|
__consul_template \
|
|
|
|
--version 0.6.5 \
|
|
|
|
--retry 30s
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2016-06-30 10:09:07 +00:00
|
|
|
consul documentation at: <https://github.com/hashicorp/consul-template>.
|
2016-06-17 19:28:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
AUTHORS
|
|
|
|
-------
|
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
-------
|
2016-08-10 16:15:54 +00:00
|
|
|
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.
|