Add trigger chapter and improve trigger and preos docs.

This commit is contained in:
Darko Poljak 2016-11-27 18:05:25 +01:00
parent 6874d9a207
commit 8aecdde1c6
19 changed files with 483 additions and 220 deletions

View File

@ -41,28 +41,14 @@ proper dhcp, tftp setting).
Since PreOS is configured with ssh authorized key it can be accessed throguh
ssh, i.e. it can be further installed and configured with cdist.
Triggering installation/configuration
-------------------------------------
When installing and configuring new machines using cdist's PreOS concept
cdist also supports triggering for host installation/configuration.
At management node you start trigger server as:
.. code-block:: sh
$ cdist trigger -b -v -i ~/.cdist/manifest/init-for-triggered
This will start cdist trigger server in verbose mode. It accepts simple
requests for configuration and for installation:
* :strong:`/install/.*` for installation
* :strong:`/config/.*` for configuration.
cdist can use triggering for host installation/configuration, which is described
in the previous chapter.
When new machine is booted with PreOS then trigger command is executed.
Machine will connect to cdist trigger server. If the request is, for example,
for installation then cdist trigger server will start install command for the
client host using parameters specified at trigger server startup. For the
above example that means that client will be installed using specified initial
manifest ``~/.cdist/manifest/init-for-triggered``.
client host using parameters specified at trigger server startup.
Implementing new PreOS sub-command
----------------------------------

View File

@ -0,0 +1,24 @@
Trigger
=======
Description
-----------
cdist supports triggering for host installation/configuration using trigger command.
This command starts trigger server at management node, for example:
.. code-block:: sh
$ cdist trigger -b -v -i ~/.cdist/manifest/init-for-triggered
This will start cdist trigger server in verbose mode. cdist trigger server accepts
simple requests for configuration and for installation:
* :strong:`/install/.*` for installation
* :strong:`/config/.*` for configuration.
Machines can then trigger cdist trigger server with appropriate requests.
If the request is, for example, for installation (:strong:`/install/`)
then cdist trigger server will start install command for the client host using
parameters specified at trigger server startup. For the above example that means
that client will be installed using specified initial manifest,
``~/.cdist/manifest/init-for-triggered``.

View File

@ -25,6 +25,7 @@ Contents:
cdist-messaging
cdist-parallelization
cdist-inventory
cdist-trigger
cdist-preos
cdist-reference
cdist-best-practice

View File

@ -630,12 +630,12 @@ usage. Its primary use is for debugging type parameters.
TRIGGER
-------
Start trigger (simple http server) that waits for connections. When host
connects then it triggers config or install command, cdist config is then
executed which configures/installs host.
Request path recognies following formats:
connects then it triggers config or install command, cdist config/install is
then executed which configures/installs host.
Request path recognizes following requests:
* :strong:`/config/.*` for config
* :strong:`/install/.*` for install
* :strong:`/install/.*` for install
.. option:: -6, --ipv6

View File

@ -34,7 +34,7 @@
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="cdist 4.3.2-288-gff95a39 documentation" href="index.html"/>
<link rel="next" title="18. PreOS" href="cdist-preos.html"/>
<link rel="next" title="18. Trigger" href="cdist-trigger.html"/>
<link rel="prev" title="16. Parallelization" href="cdist-parallelization.html"/>
@ -111,13 +111,14 @@
<li class="toctree-l2"><a class="reference internal" href="#using-external-inventory">17.7. Using external inventory</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -367,7 +368,7 @@ can use it with cdist like:</p>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="cdist-preos.html" class="btn btn-neutral float-right" title="18. PreOS" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-trigger.html" class="btn btn-neutral float-right" title="18. Trigger" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-parallelization.html" class="btn btn-neutral" title="16. Parallelization" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>

View File

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>18. PreOS &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
<title>19. PreOS &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
@ -34,8 +34,8 @@
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="cdist 4.3.2-288-gff95a39 documentation" href="index.html"/>
<link rel="next" title="19. Reference" href="cdist-reference.html"/>
<link rel="prev" title="17. Inventory" href="cdist-inventory.html"/>
<link rel="next" title="20. Reference" href="cdist-reference.html"/>
<link rel="prev" title="18. Trigger" href="cdist-trigger.html"/>
<script src="_static/js/modernizr.min.js"></script>
@ -102,27 +102,27 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">18. PreOS</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#description">18.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="#preos-creation">18.2. PreOS creation</a></li>
<li class="toctree-l2"><a class="reference internal" href="#triggering-installation-configuration">18.3. Triggering installation/configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="#implementing-new-preos-sub-command">18.4. Implementing new PreOS sub-command</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#example-writing-new-dummy-preos-sub-command">18.4.1. Example writing new dummy preos sub-command</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#module-based-preos">18.4.1.1. Module based preos:</a></li>
<li class="toctree-l4"><a class="reference internal" href="#class-based-preos">18.4.1.2. Class based preos:</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">19. PreOS</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#description">19.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="#preos-creation">19.2. PreOS creation</a></li>
<li class="toctree-l2"><a class="reference internal" href="#implementing-new-preos-sub-command">19.3. Implementing new PreOS sub-command</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#example-writing-new-dummy-preos-sub-command">19.3.1. Example writing new dummy preos sub-command</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#module-based-preos">19.3.1.1. Module based preos:</a></li>
<li class="toctree-l4"><a class="reference internal" href="#class-based-preos">19.3.1.2. Class based preos:</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#simple-tipical-use-case-for-using-preos-and-trigger">18.5. Simple tipical use case for using PreOS and trigger</a></li>
<li class="toctree-l2"><a class="reference internal" href="#simple-tipical-use-case-for-using-preos-and-trigger">19.4. Simple tipical use case for using PreOS and trigger</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -153,7 +153,7 @@
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>18. PreOS</li>
<li>19. PreOS</li>
<li class="wy-breadcrumbs-aside">
@ -168,16 +168,16 @@
<div itemprop="articleBody">
<div class="section" id="preos">
<h1>18. PreOS<a class="headerlink" href="#preos" title="Permalink to this headline"></a></h1>
<h1>19. PreOS<a class="headerlink" href="#preos" title="Permalink to this headline"></a></h1>
<div class="section" id="description">
<h2>18.1. Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<h2>19.1. Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>With cdist you can install and configure new machines. You can use cdist to
create PreOS, minimal OS which purpose is to boot new machine.
After PreOS is booted machine is ready for installing desired OS and
then it is ready for configuration.</p>
</div>
<div class="section" id="preos-creation">
<h2>18.2. PreOS creation<a class="headerlink" href="#preos-creation" title="Permalink to this headline"></a></h2>
<h2>19.2. PreOS creation<a class="headerlink" href="#preos-creation" title="Permalink to this headline"></a></h2>
<p>With cdist you can create PreOS.
Currently supported PreOS-es include:</p>
<ul class="simple">
@ -202,30 +202,16 @@ boot directory will be created (<code class="docutils literal"><span class="pre"
proper dhcp, tftp setting).</p>
<p>Since PreOS is configured with ssh authorized key it can be accessed throguh
ssh, i.e. it can be further installed and configured with cdist.</p>
</div>
<div class="section" id="triggering-installation-configuration">
<h2>18.3. Triggering installation/configuration<a class="headerlink" href="#triggering-installation-configuration" title="Permalink to this headline"></a></h2>
<p>When installing and configuring new machines using cdist's PreOS concept
cdist also supports triggering for host installation/configuration.
At management node you start trigger server as:</p>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist trigger -b -v -i ~/.cdist/manifest/init-for-triggered
</pre></div>
</div>
<p>This will start cdist trigger server in verbose mode. It accepts simple
requests for configuration and for installation:</p>
<ul class="simple">
<li><strong>/install/.*</strong> for installation</li>
<li><strong>/config/.*</strong> for configuration.</li>
</ul>
cdist can use triggering for host installation/configuration, which is described
in the previous chapter.</p>
<p>When new machine is booted with PreOS then trigger command is executed.
Machine will connect to cdist trigger server. If the request is, for example,
for installation then cdist trigger server will start install command for the
client host using parameters specified at trigger server startup. For the
above example that means that client will be installed using specified initial
manifest <code class="docutils literal"><span class="pre">~/.cdist/manifest/init-for-triggered</span></code>.</p>
client host using parameters specified at trigger server startup.</p>
</div>
<div class="section" id="implementing-new-preos-sub-command">
<h2>18.4. Implementing new PreOS sub-command<a class="headerlink" href="#implementing-new-preos-sub-command" title="Permalink to this headline"></a></h2>
<h2>19.3. Implementing new PreOS sub-command<a class="headerlink" href="#implementing-new-preos-sub-command" title="Permalink to this headline"></a></h2>
<p>preos command is implemented as a plugin system. This plugin system scans for
preos subcommands in <code class="docutils literal"><span class="pre">cdist/preos/</span></code> distribution directory and also in
<code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> directory if it exists.</p>
@ -248,9 +234,9 @@ When registered preos subcommand is specified as preos command then <code class=
will be called with first argument set to module/class object and second argument
set to <code class="docutils literal"><span class="pre">sys.argv[2:]</span></code>.</p>
<div class="section" id="example-writing-new-dummy-preos-sub-command">
<h3>18.4.1. Example writing new dummy preos sub-command<a class="headerlink" href="#example-writing-new-dummy-preos-sub-command" title="Permalink to this headline"></a></h3>
<h3>19.3.1. Example writing new dummy preos sub-command<a class="headerlink" href="#example-writing-new-dummy-preos-sub-command" title="Permalink to this headline"></a></h3>
<div class="section" id="module-based-preos">
<h4>18.4.1.1. Module based preos:<a class="headerlink" href="#module-based-preos" title="Permalink to this headline"></a></h4>
<h4>19.3.1.1. Module based preos:<a class="headerlink" href="#module-based-preos" title="Permalink to this headline"></a></h4>
<ol class="arabic simple">
<li>Create directory <code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal"><span class="pre">~/.cdist/preos/netbsd.py</span></code> with the following contents:</li>
@ -279,7 +265,7 @@ NetBSD PreOS: <span class="o">[]</span>
</div>
</div>
<div class="section" id="class-based-preos">
<h4>18.4.1.2. Class based preos:<a class="headerlink" href="#class-based-preos" title="Permalink to this headline"></a></h4>
<h4>19.3.1.2. Class based preos:<a class="headerlink" href="#class-based-preos" title="Permalink to this headline"></a></h4>
<ol class="arabic simple">
<li>Create directory <code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal"><span class="pre">~/.cdist/preos/freebsd.py</span></code> with the following contents:</li>
@ -313,7 +299,7 @@ PreOS.</p>
</div>
</div>
<div class="section" id="simple-tipical-use-case-for-using-preos-and-trigger">
<h2>18.5. Simple tipical use case for using PreOS and trigger<a class="headerlink" href="#simple-tipical-use-case-for-using-preos-and-trigger" title="Permalink to this headline"></a></h2>
<h2>19.4. Simple tipical use case for using PreOS and trigger<a class="headerlink" href="#simple-tipical-use-case-for-using-preos-and-trigger" title="Permalink to this headline"></a></h2>
<p>Tipical use case for using PreOS and trigger command include the following steps.</p>
<ol class="arabic">
<li><p class="first">Create PreOS PXE with ssh key and trigger command for installation.</p>
@ -354,10 +340,10 @@ default init manifest for installation).</p>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="cdist-reference.html" class="btn btn-neutral float-right" title="19. Reference" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-reference.html" class="btn btn-neutral float-right" title="20. Reference" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-inventory.html" class="btn btn-neutral" title="17. Inventory" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
<a href="cdist-trigger.html" class="btn btn-neutral" title="18. Trigger" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>

View File

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>19. Reference &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
<title>20. Reference &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
@ -34,8 +34,8 @@
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="cdist 4.3.2-288-gff95a39 documentation" href="index.html"/>
<link rel="next" title="20. Best practice" href="cdist-best-practice.html"/>
<link rel="prev" title="18. PreOS" href="cdist-preos.html"/>
<link rel="next" title="21. Best practice" href="cdist-best-practice.html"/>
<link rel="prev" title="19. PreOS" href="cdist-preos.html"/>
<script src="_static/js/modernizr.min.js"></script>
@ -102,21 +102,22 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">19. Reference</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#explorers">19.1. Explorers</a></li>
<li class="toctree-l2"><a class="reference internal" href="#paths">19.2. Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="#types">19.3. Types</a></li>
<li class="toctree-l2"><a class="reference internal" href="#objects">19.4. Objects</a></li>
<li class="toctree-l2"><a class="reference internal" href="#environment-variables-for-reading">19.5. Environment variables (for reading)</a></li>
<li class="toctree-l2"><a class="reference internal" href="#environment-variables-for-writing">19.6. Environment variables (for writing)</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">20. Reference</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#explorers">20.1. Explorers</a></li>
<li class="toctree-l2"><a class="reference internal" href="#paths">20.2. Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="#types">20.3. Types</a></li>
<li class="toctree-l2"><a class="reference internal" href="#objects">20.4. Objects</a></li>
<li class="toctree-l2"><a class="reference internal" href="#environment-variables-for-reading">20.5. Environment variables (for reading)</a></li>
<li class="toctree-l2"><a class="reference internal" href="#environment-variables-for-writing">20.6. Environment variables (for writing)</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -147,7 +148,7 @@
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>19. Reference</li>
<li>20. Reference</li>
<li class="wy-breadcrumbs-aside">
@ -162,10 +163,10 @@
<div itemprop="articleBody">
<div class="section" id="reference">
<h1>19. Reference<a class="headerlink" href="#reference" title="Permalink to this headline"></a></h1>
<h1>20. Reference<a class="headerlink" href="#reference" title="Permalink to this headline"></a></h1>
<p>Variable, path and type reference for cdist</p>
<div class="section" id="explorers">
<h2>19.1. Explorers<a class="headerlink" href="#explorers" title="Permalink to this headline"></a></h2>
<h2>20.1. Explorers<a class="headerlink" href="#explorers" title="Permalink to this headline"></a></h2>
<p>The following global explorers are available:</p>
<ul class="simple">
<li>cpu_cores</li>
@ -187,7 +188,7 @@
</ul>
</div>
<div class="section" id="paths">
<h2>19.2. Paths<a class="headerlink" href="#paths" title="Permalink to this headline"></a></h2>
<h2>20.2. Paths<a class="headerlink" href="#paths" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>$HOME/.cdist</dt>
<dd>The standard cdist configuration directory relative to your home directory.
@ -268,7 +269,7 @@ This directory is referenced by the variable __object (see below).</dd>
</dl>
</div>
<div class="section" id="types">
<h2>19.3. Types<a class="headerlink" href="#types" title="Permalink to this headline"></a></h2>
<h2>20.3. Types<a class="headerlink" href="#types" title="Permalink to this headline"></a></h2>
<p>The following types are available:</p>
<ul class="simple">
<li>__apt_key (<a class="reference external" href="man7/cdist-type__apt_key.html">cdist-type__apt_key(7)</a>)</li>
@ -392,7 +393,7 @@ This directory is referenced by the variable __object (see below).</dd>
</ul>
</div>
<div class="section" id="objects">
<h2>19.4. Objects<a class="headerlink" href="#objects" title="Permalink to this headline"></a></h2>
<h2>20.4. Objects<a class="headerlink" href="#objects" title="Permalink to this headline"></a></h2>
<p>For object to object communication and tests, the following paths are
usable within a object directory:</p>
<dl class="docutils">
@ -409,7 +410,7 @@ when the type was called.</dd>
</dl>
</div>
<div class="section" id="environment-variables-for-reading">
<h2>19.5. Environment variables (for reading)<a class="headerlink" href="#environment-variables-for-reading" title="Permalink to this headline"></a></h2>
<h2>20.5. Environment variables (for reading)<a class="headerlink" href="#environment-variables-for-reading" title="Permalink to this headline"></a></h2>
<p>The following environment variables are exported by cdist:</p>
<dl class="docutils">
<dt>__explorer</dt>
@ -466,7 +467,7 @@ Available for: type explorer.</dd>
</dl>
</div>
<div class="section" id="environment-variables-for-writing">
<h2>19.6. Environment variables (for writing)<a class="headerlink" href="#environment-variables-for-writing" title="Permalink to this headline"></a></h2>
<h2>20.6. Environment variables (for writing)<a class="headerlink" href="#environment-variables-for-writing" title="Permalink to this headline"></a></h2>
<p>The following environment variables influence the behaviour of cdist:</p>
<dl class="docutils">
<dt>require</dt>
@ -498,10 +499,10 @@ Available for: type explorer.</dd>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="cdist-best-practice.html" class="btn btn-neutral float-right" title="20. Best practice" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-best-practice.html" class="btn btn-neutral float-right" title="21. Best practice" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-preos.html" class="btn btn-neutral" title="18. PreOS" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
<a href="cdist-preos.html" class="btn btn-neutral" title="19. PreOS" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>

View File

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>22. Remote exec and copy commands &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
<title>23. Remote exec and copy commands &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
@ -34,8 +34,8 @@
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="cdist 4.3.2-288-gff95a39 documentation" href="index.html"/>
<link rel="next" title="23. Hacking" href="cdist-hacker.html"/>
<link rel="prev" title="21. Execution stages" href="cdist-stages.html"/>
<link rel="next" title="24. Hacking" href="cdist-hacker.html"/>
<link rel="prev" title="22. Execution stages" href="cdist-stages.html"/>
<script src="_static/js/modernizr.min.js"></script>
@ -102,13 +102,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -139,7 +140,7 @@
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>22. Remote exec and copy commands</li>
<li>23. Remote exec and copy commands</li>
<li class="wy-breadcrumbs-aside">
@ -154,7 +155,7 @@
<div itemprop="articleBody">
<div class="section" id="remote-exec-and-copy-commands">
<h1>22. Remote exec and copy commands<a class="headerlink" href="#remote-exec-and-copy-commands" title="Permalink to this headline"></a></h1>
<h1>23. Remote exec and copy commands<a class="headerlink" href="#remote-exec-and-copy-commands" title="Permalink to this headline"></a></h1>
<p>Cdist interacts with the target host in two ways:</p>
<ul class="simple">
<li>it executes code (__remote_exec)</li>
@ -182,10 +183,10 @@ remains as simple as possible.</p>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="cdist-hacker.html" class="btn btn-neutral float-right" title="23. Hacking" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-hacker.html" class="btn btn-neutral float-right" title="24. Hacking" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-stages.html" class="btn btn-neutral" title="21. Execution stages" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
<a href="cdist-stages.html" class="btn btn-neutral" title="22. Execution stages" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>

View File

@ -0,0 +1,252 @@
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>18. Trigger &mdash; cdist 4.3.2-288-gff95a39 documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="index" title="Index"
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="cdist 4.3.2-288-gff95a39 documentation" href="index.html"/>
<link rel="next" title="19. PreOS" href="cdist-preos.html"/>
<link rel="prev" title="17. Inventory" href="cdist-inventory.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> cdist
</a>
<div class="version">
4.3.2-288-gff95a39
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="cdist-intro.html">1. cdist - usable configuration management</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-why.html">2. Why should I use cdist?</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-os.html">3. Supported Operating Systems</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-install.html">4. How to install cdist</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-update.html">5. How to update cdist</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-support.html">6. Support</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-features.html">7. Features</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-quickstart.html">8. Quickstart</a></li>
<li class="toctree-l1"><a class="reference internal" href="man1/cdist.html">9. cdist(1)</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-bootstrap.html">10. Bootstrap</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-manifest.html">11. Manifest</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-type.html">12. cdist type</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-types.html">13. cdist types</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-explorer.html">14. Explorer</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">18. Trigger</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#description">18.1. Description</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">cdist</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>18. Trigger</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/cdist-trigger.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="trigger">
<h1>18. Trigger<a class="headerlink" href="#trigger" title="Permalink to this headline"></a></h1>
<div class="section" id="description">
<h2>18.1. Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>cdist supports triggering for host installation/configuration using trigger command.
This command starts trigger server at management node, for example:</p>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist trigger -b -v -i ~/.cdist/manifest/init-for-triggered
</pre></div>
</div>
<p>This will start cdist trigger server in verbose mode. cdist trigger server accepts
simple requests for configuration and for installation:</p>
<ul class="simple">
<li><strong>/install/.*</strong> for installation</li>
<li><strong>/config/.*</strong> for configuration.</li>
</ul>
<p>Machines can then trigger cdist trigger server with appropriate requests.
If the request is, for example, for installation (<strong>/install/</strong>)
then cdist trigger server will start install command for the client host using
parameters specified at trigger server startup. For the above example that means
that client will be installed using specified initial manifest,
<code class="docutils literal"><span class="pre">~/.cdist/manifest/init-for-triggered</span></code>.</p>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="cdist-preos.html" class="btn btn-neutral float-right" title="19. PreOS" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="cdist-inventory.html" class="btn btn-neutral" title="17. Inventory" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright .
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'4.3.2-288-gff95a39',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>

View File

@ -119,13 +119,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

View File

@ -222,13 +222,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

View File

@ -101,13 +101,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

View File

@ -101,13 +101,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -399,60 +400,63 @@
<li class="toctree-l2"><a class="reference internal" href="cdist-inventory.html#using-external-inventory">17.7. Using external inventory</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#description">18.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#preos-creation">18.2. PreOS creation</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#triggering-installation-configuration">18.3. Triggering installation/configuration</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#implementing-new-preos-sub-command">18.4. Implementing new PreOS sub-command</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#simple-tipical-use-case-for-using-preos-and-trigger">18.5. Simple tipical use case for using PreOS and trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-trigger.html#description">18.1. Description</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#explorers">19.1. Explorers</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#paths">19.2. Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#types">19.3. Types</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#objects">19.4. Objects</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#environment-variables-for-reading">19.5. Environment variables (for reading)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#environment-variables-for-writing">19.6. Environment variables (for writing)</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#description">19.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#preos-creation">19.2. PreOS creation</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#implementing-new-preos-sub-command">19.3. Implementing new PreOS sub-command</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-preos.html#simple-tipical-use-case-for-using-preos-and-trigger">19.4. Simple tipical use case for using PreOS and trigger</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#passwordless-connections">20.1. Passwordless connections</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#speeding-up-ssh-connections">20.2. Speeding up ssh connections</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#speeding-up-shell-execution">20.3. Speeding up shell execution</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#multi-master-or-environment-setups">20.4. Multi master or environment setups</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#separating-work-by-groups">20.5. Separating work by groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#maintaining-multiple-configurations">20.6. Maintaining multiple configurations</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#multiple-developers-with-different-trust">20.7. Multiple developers with different trust</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#templating">20.8. Templating</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#testing-a-new-type">20.9. Testing a new type</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#other-content-in-cdist-repository">20.10. Other content in cdist repository</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#explorers">20.1. Explorers</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#paths">20.2. Paths</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#types">20.3. Types</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#objects">20.4. Objects</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#environment-variables-for-reading">20.5. Environment variables (for reading)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-reference.html#environment-variables-for-writing">20.6. Environment variables (for writing)</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#description">21.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-1-target-information-retrieval">21.2. Stage 1: target information retrieval</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-2-run-the-initial-manifest">21.3. Stage 2: run the initial manifest</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-3-object-information-retrieval">21.4. Stage 3: object information retrieval</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-4-run-the-object-manifest">21.5. Stage 4: run the object manifest</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-5-code-generation">21.6. Stage 5: code generation</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-6-code-execution">21.7. Stage 6: code execution</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-7-cache">21.8. Stage 7: cache</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#summary">21.9. Summary</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#passwordless-connections">21.1. Passwordless connections</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#speeding-up-ssh-connections">21.2. Speeding up ssh connections</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#speeding-up-shell-execution">21.3. Speeding up shell execution</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#multi-master-or-environment-setups">21.4. Multi master or environment setups</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#separating-work-by-groups">21.5. Separating work by groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#maintaining-multiple-configurations">21.6. Maintaining multiple configurations</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#multiple-developers-with-different-trust">21.7. Multiple developers with different trust</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#templating">21.8. Templating</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#testing-a-new-type">21.9. Testing a new type</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-best-practice.html#other-content-in-cdist-repository">21.10. Other content in cdist repository</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#welcome">23.1. Welcome</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#reporting-bugs">23.2. Reporting bugs</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#coding-conventions-everywhere">23.3. Coding conventions (everywhere)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#how-to-submit-stuff-for-inclusion-into-upstream-cdist">23.4. How to submit stuff for inclusion into upstream cdist</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#how-to-submit-a-new-type">23.5. How to submit a new type</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#example-git-workflow">23.6. Example git workflow</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#description">22.1. Description</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-1-target-information-retrieval">22.2. Stage 1: target information retrieval</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-2-run-the-initial-manifest">22.3. Stage 2: run the initial manifest</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-3-object-information-retrieval">22.4. Stage 3: object information retrieval</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-4-run-the-object-manifest">22.5. Stage 4: run the object manifest</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-5-code-generation">22.6. Stage 5: code generation</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-6-code-execution">22.7. Stage 6: code execution</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#stage-7-cache">22.8. Stage 7: cache</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-stages.html#summary">22.9. Summary</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-troubleshooting.html#error-in-manifest-is-not-considered-an-error-by-cdist">24.1. Error in manifest is not considered an error by cdist</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#welcome">24.1. Welcome</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#reporting-bugs">24.2. Reporting bugs</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#coding-conventions-everywhere">24.3. Coding conventions (everywhere)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#how-to-submit-stuff-for-inclusion-into-upstream-cdist">24.4. How to submit stuff for inclusion into upstream cdist</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#how-to-submit-a-new-type">24.5. How to submit a new type</a></li>
<li class="toctree-l2"><a class="reference internal" href="cdist-hacker.html#example-git-workflow">24.6. Example git workflow</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cdist-troubleshooting.html#error-in-manifest-is-not-considered-an-error-by-cdist">25.1. Error in manifest is not considered an error by cdist</a></li>
</ul>
</li>
</ul>

View File

@ -131,13 +131,14 @@
<li class="toctree-l1"><a class="reference internal" href="../cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>
@ -972,9 +973,9 @@ be POSIX compatible shell.</p>
<div class="section" id="trigger">
<h2>9.17. TRIGGER<a class="headerlink" href="#trigger" title="Permalink to this headline"></a></h2>
<p>Start trigger (simple http server) that waits for connections. When host
connects then it triggers config or install command, cdist config is then
executed which configures/installs host.
Request path recognies following formats:</p>
connects then it triggers config or install command, cdist config/install is
then executed which configures/installs host.
Request path recognizes following requests:</p>
<ul class="simple">
<li><strong>/config/.*</strong> for config</li>
<li><strong>/install/.*</strong> for install</li>

View File

@ -232,13 +232,14 @@
<li class="toctree-l1"><a class="reference internal" href="../cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

View File

@ -233,13 +233,14 @@
<li class="toctree-l1"><a class="reference internal" href="../cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

Binary file not shown.

View File

@ -100,13 +100,14 @@
<li class="toctree-l1"><a class="reference internal" href="cdist-messaging.html">15. Messaging</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-parallelization.html">16. Parallelization</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-inventory.html">17. Inventory</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">18. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">19. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">20. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">21. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">22. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">23. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">24. Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-trigger.html">18. Trigger</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-preos.html">19. PreOS</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-reference.html">20. Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-best-practice.html">21. Best practice</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-stages.html">22. Execution stages</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-remote-exec-copy.html">23. Remote exec and copy commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-hacker.html">24. Hacking</a></li>
<li class="toctree-l1"><a class="reference internal" href="cdist-troubleshooting.html">25. Troubleshooting</a></li>
</ul>

File diff suppressed because one or more lines are too long