cdist/cdist/conf/type/__consul/man.text

72 lines
1.9 KiB
Plaintext

cdist-type__consul(7)
=====================
Steven Armstrong <steven-cdist--@--armstrong.cc>
NAME
----
cdist-type__consul - install consul
DESCRIPTION
-----------
Quick and dirty installation of the consul binary.
Note that the consul binary is downloaded on the server and then deployed using
the __file type.
Future ideas:
- get latest version info from https://checkpoint-api.hashicorp.com/v1/check/consul
- then download from
https://dl.bintray.com/mitchellh/consul/${current_version}_${os}_${arch}.zip
- install from given path to binary
- download from given url
- install from packet
OPTIONAL PARAMETERS
-------------------
install-from::
uri from where to download consul. This can be anything that curl understands.
If install-uri ends with .zip the downloaded file will be unziped and the
contained file deployed as the consul binary. If install-uri does not end in .zip
it is assumed to be the consul binary and will be deployed as is.
install-to::
where to install the binary. Defaults to /usr/local/bin/consul
state::
either 'present' or 'absent'. Defaults to 'present'
EXAMPLES
--------
--------------------------------------------------------------------------------
# just install using defaults
__consul
# download on the machine running cdist, then unzip, then upload to the target host
__consul \
--install-from https://dl.bintray.com/mitchellh/consul/0.4.1_linux_amd64.zip
# take binary from local folder on the machine running cdist
__consul \
--install-from file:///cluster/adm/software/consul/bin/consul
# install the consul binary to a specific location
__consul \
--install-to /somewhere/special/consul
--------------------------------------------------------------------------------
SEE ALSO
--------
- cdist-type(7)
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).