2015-02-24 12:10:17 +00:00
|
|
|
cdist-type__consul_watch_keyprefix(7)
|
|
|
|
=====================================
|
2016-05-20 06:50:56 +00:00
|
|
|
Manages consul keyprefix watches
|
2015-02-24 12:10:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Generate and deploy watch definitions of type 'keyprefix' for a consul agent.
|
|
|
|
See http://www.consul.io/docs/agent/watches.html for parameter documentation.
|
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
handler
|
2015-02-24 12:10:17 +00:00
|
|
|
the handler to invoke when the data view updates
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
prefix
|
2015-02-24 12:10:17 +00:00
|
|
|
the prefix of keys to watch for changes
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
datacenter
|
2015-02-24 12:10:17 +00:00
|
|
|
can be provided to override the agent's default datacenter
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
state
|
2015-02-24 12:10:17 +00:00
|
|
|
if this watch is 'present' or 'absent'. Defaults to 'present'.
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
token
|
2015-02-24 12:10:17 +00:00
|
|
|
can be provided to override the agent's default ACL token
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
__consul_watch_keyprefix some-id \
|
|
|
|
--prefix foo/ \
|
|
|
|
--handler /usr/bin/my-prefix-handler.sh
|
2015-02-24 12:10:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2016-05-20 06:50:56 +00:00
|
|
|
- `cdist-type(7) <cdist-type.html>`_
|
|
|
|
- `cdist-type__consul_agent(7) <cdist-type__consul_agent.html>`_
|
2015-02-24 12:10:17 +00:00
|
|
|
- http://www.consul.io/docs/agent/watches.html
|
|
|
|
|
|
|
|
|
|
|
|
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).
|