2015-02-24 12:10:17 +00:00
|
|
|
cdist-type__consul_service(7)
|
|
|
|
=============================
|
2016-05-20 06:50:56 +00:00
|
|
|
Manages consul services
|
2015-02-24 12:10:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Generate and deploy service definitions for a consul agent.
|
|
|
|
See http://www.consul.io/docs/agent/services.html for parameter documentation.
|
|
|
|
|
|
|
|
Use either script together with interval, or use ttl.
|
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
check-interval
|
2015-02-24 12:10:17 +00:00
|
|
|
the interval in which the script given with --check-script should be run
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
check-script
|
2015-02-24 12:10:17 +00:00
|
|
|
the shell command to run every --check-interval
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
check-ttl
|
2015-02-24 12:10:17 +00:00
|
|
|
how long a service is considered healthy without being updated through the
|
|
|
|
HTTP interfave
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
id
|
2015-02-24 12:10:17 +00:00
|
|
|
Defaults to --name
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
name
|
2015-02-24 12:10:17 +00:00
|
|
|
The name of this service. Defaults to __object_id
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
port
|
2015-02-24 12:10:17 +00:00
|
|
|
the port at which this service can be reached
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
state
|
2015-02-24 12:10:17 +00:00
|
|
|
if this service is 'present' or 'absent'. Defaults to 'present'.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
tag
|
2015-02-24 12:10:17 +00:00
|
|
|
a tag to add to this service. Can be specified multiple times.
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
__consul_service redis \
|
|
|
|
--tag master \
|
|
|
|
--tag production \
|
|
|
|
--port 8000 \
|
|
|
|
--check-script /usr/local/bin/check_redis.py \
|
|
|
|
--check-interval 10s
|
2015-02-24 12:10:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
__consul_service webapp \
|
|
|
|
--port 80 \
|
|
|
|
--check-ttl 10s
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2016-05-20 06:50:56 +00:00
|
|
|
- `cdist-type(7) <cdist-type.html>`_
|
|
|
|
- `cdist-type__consul_agent(7) <cdist-type__consul_agent.html>`_
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
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).
|