13.24. cdist-type__consul_watch_service(7)

13.24.1. NAME

cdist-type__consul_watch_service - Manages consul service watches

13.24.2. DESCRIPTION

Generate and deploy watch definitions of type ‘service’ for a consul agent. See http://www.consul.io/docs/agent/watches.html for parameter documentation.

13.24.3. REQUIRED PARAMETERS

handler
the handler to invoke when the data view updates
service
the service to watch for changes

13.24.4. OPTIONAL PARAMETERS

datacenter
can be provided to override the agent’s default datacenter
state
if this watch is ‘present’ or ‘absent’. Defaults to ‘present’.
token
can be provided to override the agent’s default ACL token
tag
filter by tag

13.24.5. BOOLEAN PARAMETERS

passingonly
specifies if only hosts passing all checks are displayed

13.24.6. EXAMPLES

__consul_watch_service some-id \
   --service consul \
   --handler /usr/bin/my-handler.sh

__consul_watch_service some-id \
   --service redis \
   --tag production \
   --handler /usr/bin/my-handler.sh

__consul_watch_service some-id \
   --service redis \
   --tag production \
   --passingonly \
   --handler /usr/bin/my-handler.sh

13.24.7. SEE ALSO

cdist-type__consul_agent(7)

consul documentation at: <http://www.consul.io/docs/agent/watches.html>.

13.24.8. AUTHORS

Steven Armstrong <steven-cdist--@--armstrong.cc>

13.24.9. 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).