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