16.31. cdist-type__consul_watch_service(7)¶

16.31.1. NAME¶

cdist-type__consul_watch_service - Manages consul service watches

16.31.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.

16.31.3. REQUIRED PARAMETERS¶

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

16.31.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

16.31.5. BOOLEAN PARAMETERS¶

passingonly: specifies if only hosts passing all checks are displayed

16.31.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

16.31.7. SEE ALSO¶

cdist-type__consul_agent(7)

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

16.31.8. AUTHORS¶

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

16.31.9. COPYING¶

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.