cdist-type__consul_watch

cdist-type__consul_watch_service(7)

Steven Armstrong

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

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. BOOLEAN PARAMETERS
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__consul_watch_service - manages consul service watches

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.

3. REQUIRED PARAMETERS

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

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

5. BOOLEAN PARAMETERS

passingonly: specifies if only hosts passing all checks are displayed

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