16.34. cdist-type__consul_watch_service(7)¶
16.34.1. NAME¶
cdist-type__consul_watch_service - Manages consul service watches
16.34.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.34.3. REQUIRED PARAMETERS¶
- handler
the handler to invoke when the data view updates
- service
the service to watch for changes
16.34.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.34.5. BOOLEAN PARAMETERS¶
- passingonly
specifies if only hosts passing all checks are displayed
16.34.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.34.7. SEE ALSO¶
cdist-type__consul_agent(7)
consul documentation at: <http://www.consul.io/docs/agent/watches.html>.
16.34.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.