carta
cdist-type__consul_watch_service(7)

cdist-type__consul_watch_service7

Manages consul service watches

Overview

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

Required parameters

handler

the handler to invoke when the data view updates

service

the service to watch for changes

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

Boolean parameters

passingonly

specifies if only hosts passing all checks are displayed

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

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.

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

Authors

Steven Armstrong <[email protected]>

From cdist 7.0.0-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.