2015-02-24 12:10:17 +00:00
|
|
|
cdist-type__consul_check(7)
|
|
|
|
=============================
|
2016-06-23 14:08:59 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
cdist-type__consul_check - Manages consul checks
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Generate and deploy check definitions for a consul agent.
|
|
|
|
See http://www.consul.io/docs/agent/checks.html for parameter documentation.
|
|
|
|
|
|
|
|
Use either script toghether with interval, or use ttl.
|
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2016-06-22 21:58:14 +00:00
|
|
|
docker-container-id
|
|
|
|
the id of the docker container to run
|
2016-05-20 06:50:56 +00:00
|
|
|
|
2016-06-22 21:58:14 +00:00
|
|
|
http
|
|
|
|
the url to check
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
id
|
2016-06-22 21:58:14 +00:00
|
|
|
The id of this check.
|
|
|
|
|
|
|
|
interval
|
|
|
|
the interval in which the check should run
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
name
|
2015-02-24 12:10:17 +00:00
|
|
|
The name of this check. Defaults to __object_id
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
notes
|
2015-02-24 12:10:17 +00:00
|
|
|
human readable description
|
2016-05-20 06:50:56 +00:00
|
|
|
|
2016-06-22 21:58:14 +00:00
|
|
|
script
|
|
|
|
the shell command to run
|
|
|
|
|
|
|
|
service-id
|
|
|
|
the id of the service this check is bound to
|
|
|
|
|
|
|
|
shell
|
|
|
|
the shell to run inside the docker container
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
state
|
2015-02-24 12:10:17 +00:00
|
|
|
if this check is 'present' or 'absent'. Defaults to 'present'.
|
|
|
|
|
2016-06-22 21:58:14 +00:00
|
|
|
status
|
|
|
|
specify the initial state of this health check
|
|
|
|
|
|
|
|
tcp
|
|
|
|
the host and port to check
|
|
|
|
|
|
|
|
timeout
|
|
|
|
after how long to timeout checks which take to long
|
|
|
|
|
|
|
|
token
|
|
|
|
ACL token to use for interacting with the catalog
|
|
|
|
|
|
|
|
ttl
|
|
|
|
how long a TTL check is considered healthy without being updated through the
|
|
|
|
HTTP interface
|
|
|
|
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
__consul_check redis \
|
|
|
|
--script /usr/local/bin/check_redis.py \
|
|
|
|
--interval 10s
|
2015-02-24 12:10:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
__consul_check some-object-id \
|
|
|
|
--id web-app \
|
|
|
|
--name "Web App Status" \
|
|
|
|
--notes "Web app does a curl internally every 10 seconds" \
|
|
|
|
--ttl 30s
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2016-06-30 13:12:32 +00:00
|
|
|
:strong:`cdist-type__consul_agent`\ (7)
|
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-06-22 21:58:14 +00:00
|
|
|
Copyright \(C) 2015-2016 Steven Armstrong. Free use of this software is
|
2015-02-24 12:10:17 +00:00
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|