This commit is contained in:
Michael DeHaan 2012-08-09 22:12:10 -04:00
commit b721176bdd
6 changed files with 131 additions and 72 deletions

View file

@ -305,6 +305,8 @@ apt pkg=openjdk-6-jdk state=latest install-recommends=no</pre>
</div>
<div class="section" id="apt-repository">
<span id="id2"></span><h2>apt_repository<a class="headerlink" href="#apt-repository" title="Permalink to this headline"></a></h2>
<p class="versionadded">
<span class="versionmodified">New in version 0.7.</span></p>
<p>Manages apt repositores</p>
<table border="1" class="docutils">
<colgroup>
@ -466,9 +468,13 @@ arguments, space delimited.</p>
be processed through the shell, so variables like &#8220;$HOME&#8221; and
operations like &#8220;&lt;&#8221;, &#8220;&gt;&#8221;, &#8220;|&#8221;, and &#8220;&amp;&#8221; will not work. As such, all
paths to commands must be fully qualified.</p>
<p>NOTE:: If you want to run a command through the shell (say you are using
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">If you want to run a command through the shell (say you are using
&#8216;&lt;&#8217;, &#8216;&gt;&#8217;, &#8216;|&#8217;, etc), you actually want the &#8216;shell&#8217; module instead.
The &#8216;command&#8217; module is much more secure as it&#8217;s not affected by the user&#8217;s environment.</p>
The &#8216;command&#8217; module is much more secure as it&#8217;s not affected by
the user&#8217;s environment.</p>
</div>
<p>Example action from Ansible <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a>:</p>
<div class="highlight-python"><pre>command /sbin/shutdown -t now</pre>
</div>
@ -521,6 +527,8 @@ relative.</td>
</div>
<div class="section" id="easy-install">
<span id="easyinstall"></span><h2>easy_install<a class="headerlink" href="#easy-install" title="Permalink to this headline"></a></h2>
<p class="versionadded">
<span class="versionmodified">New in version 0.7.</span></p>
<p>The easy_install module installs Python libraries.</p>
<table border="1" class="docutils">
<colgroup>
@ -1059,6 +1067,8 @@ from /usr/bin/ansible:</p>
</div>
<div class="section" id="pip">
<span id="id17"></span><h2>pip<a class="headerlink" href="#pip" title="Permalink to this headline"></a></h2>
<p class="versionadded">
<span class="versionmodified">New in version 0.7.</span></p>
<p>Manages Python library dependencies.</p>
<table border="1" class="docutils">
<colgroup>
@ -1415,17 +1425,22 @@ but runs the command through the user&#8217;s configured shell on the remote nod
</tbody>
</table>
<p>The given command will be executed on all selected nodes.</p>
<p>NOTE:: If you want to execute a command securely and predicably, it may
be better to use the &#8216;command&#8217; module instead. Best practices
when writing playbooks will follow the trend of using &#8216;command&#8217;
unless &#8216;shell&#8217; is explicitly required. When running ad-hoc commands,
use your best judgement.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">If you want to execute a command securely and predicably, it may be
better to use the &#8216;command&#8217; module instead. Best practices when
writing playbooks will follow the trend of using &#8216;command&#8217; unless
&#8216;shell&#8217; is explicitly required. When running ad-hoc commands, use
your best judgement.</p>
</div>
<p>Example action from a playbook:</p>
<div class="highlight-python"><pre>shell somescript.sh &gt;&gt; somelog.txt</pre>
</div>
</div>
<div class="section" id="supervisorctl">
<span id="id22"></span><h2>supervisorctl<a class="headerlink" href="#supervisorctl" title="Permalink to this headline"></a></h2>
<p class="versionadded">
<span class="versionmodified">New in version 0.7.</span></p>
<p>Manage the state of a program or group of programs running via Supervisord</p>
<table border="1" class="docutils">
<colgroup>