51 lines
5.3 KiB
HTML
51 lines
5.3 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>cdist-type__consul_watch_service(7)</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /></head><body><div xml:lang="en" class="article" title="cdist-type__consul_watch_service(7)" lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="idp63919696"></a>cdist-type__consul_watch_service(7)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Steven</span> <span class="surname">Armstrong</span></h3><code class="email"><<a class="email" href="mailto:steven-cdist--@--armstrong.cc">steven-cdist--@--armstrong.cc</a>></code></div></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="section"><a href="#_name">1. NAME</a></span></dt><dt><span class="section"><a href="#_description">2. DESCRIPTION</a></span></dt><dt><span class="section"><a href="#_required_parameters">3. REQUIRED PARAMETERS</a></span></dt><dt><span class="section"><a href="#_optional_parameters">4. OPTIONAL PARAMETERS</a></span></dt><dt><span class="section"><a href="#_boolean_parameters">5. BOOLEAN PARAMETERS</a></span></dt><dt><span class="section"><a href="#_examples">6. EXAMPLES</a></span></dt><dt><span class="section"><a href="#_see_also">7. SEE ALSO</a></span></dt><dt><span class="section"><a href="#_copying">8. COPYING</a></span></dt></dl></div><div class="section" title="1. NAME"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_name"></a>1. NAME</h2></div></div></div><p>cdist-type__consul_watch_service - manages consul service watches</p></div><div class="section" title="2. DESCRIPTION"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_description"></a>2. DESCRIPTION</h2></div></div></div><p>Generate and deploy watch definitions of type <span class="emphasis"><em>service</em></span> for a consul agent.
|
||
See <a class="ulink" href="http://www.consul.io/docs/agent/watches.html" target="_top">http://www.consul.io/docs/agent/watches.html</a> for parameter documentation.</p></div><div class="section" title="3. REQUIRED PARAMETERS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_required_parameters"></a>3. REQUIRED PARAMETERS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
handler
|
||
</span></dt><dd>
|
||
the handler to invoke when the data view updates
|
||
</dd><dt><span class="term">
|
||
service
|
||
</span></dt><dd>
|
||
the service to watch for changes
|
||
</dd></dl></div></div><div class="section" title="4. OPTIONAL PARAMETERS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_optional_parameters"></a>4. OPTIONAL PARAMETERS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
datacenter
|
||
</span></dt><dd>
|
||
can be provided to override the agent’s default datacenter
|
||
</dd><dt><span class="term">
|
||
state
|
||
</span></dt><dd>
|
||
if this watch is <span class="emphasis"><em>present</em></span> or <span class="emphasis"><em>absent</em></span>. Defaults to <span class="emphasis"><em>present</em></span>.
|
||
</dd><dt><span class="term">
|
||
token
|
||
</span></dt><dd>
|
||
can be provided to override the agent’s default ACL token
|
||
</dd><dt><span class="term">
|
||
tag
|
||
</span></dt><dd>
|
||
filter by tag
|
||
</dd></dl></div></div><div class="section" title="5. BOOLEAN PARAMETERS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_boolean_parameters"></a>5. BOOLEAN PARAMETERS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
passingonly
|
||
</span></dt><dd>
|
||
specifies if only hosts passing all checks are displayed
|
||
</dd></dl></div></div><div class="section" title="6. EXAMPLES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_examples"></a>6. EXAMPLES</h2></div></div></div><pre class="screen">__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</pre></div><div class="section" title="7. SEE ALSO"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_see_also"></a>7. SEE ALSO</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
|
||
<a href="../man7/cdist-type.html">cdist-type(7)</a>
|
||
</li><li class="listitem">
|
||
<a href="../man7/cdist-type__consul_agent.html">cdist-type__consul_agent(7)</a>
|
||
</li><li class="listitem">
|
||
<a class="ulink" href="http://www.consul.io/docs/agent/watches.html" target="_top">http://www.consul.io/docs/agent/watches.html</a>
|
||
</li></ul></div></div><div class="section" title="8. COPYING"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_copying"></a>8. COPYING</h2></div></div></div><p>Copyright (C) 2015 Steven Armstrong. Free use of this software is
|
||
granted under the terms of the GNU General Public License version 3 (GPLv3).</p></div></div></body></html>
|