@ -1661,8 +1667,92 @@ service name=httpd state=reloaded
service name=foo pattern=/usr/bin/foo state=started</pre>
service name=foo pattern=/usr/bin/foo state=started</pre>
</div>
</div>
</div>
</div>
<divclass="section"id="seboolean">
<spanid="id27"></span><h2><aclass="toc-backref"href="#contents">seboolean</a><aclass="headerlink"href="#seboolean"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Toggles SELinux booleans.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="16%"/>
<colwidth="8%"/>
<colwidth="17%"/>
<colwidth="60%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>name</td>
<td>yes</td>
<td> </td>
<td>name of the boolean to configure</td>
</tr>
<trclass="row-odd"><td>persistent</td>
<td>no</td>
<td>no</td>
<td>set to ‘yes’ if the boolean setting should survive a reboot</td>
</tr>
<trclass="row-even"><td>state</td>
<td>yes</td>
<td> </td>
<td>desired boolean value. ‘true’ or ‘false’.</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
<spanid="id28"></span><h2><aclass="toc-backref"href="#contents">selinux</a><aclass="headerlink"href="#selinux"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but
will let you know when it is required.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="16%"/>
<colwidth="8%"/>
<colwidth="17%"/>
<colwidth="60%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>policy</td>
<td>yes</td>
<td> </td>
<td>name of the SELinux policy to use (example: ‘targetted’)</td>
</tr>
<trclass="row-odd"><td>state</td>
<td>yes</td>
<td> </td>
<td>the SELinux mode. ‘enforcing’, ‘permissive’, or ‘disabled’</td>
</tr>
<trclass="row-even"><td>conf</td>
<td>no</td>
<td>/etc/selinux/config</td>
<td>path to the SELinux configuration file, if non-standard</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
<spanid="id27"></span><h2><aclass="toc-backref"href="#contents">setup</a><aclass="headerlink"href="#setup"title="Permalink to this headline">¶</a></h2>
<spanid="id29"></span><h2><aclass="toc-backref"href="#contents">setup</a><aclass="headerlink"href="#setup"title="Permalink to this headline">¶</a></h2>
<p>This module is automatically called by playbooks to gather useful variables about remote hosts that can be used
<p>This module is automatically called by playbooks to gather useful variables about remote hosts that can be used
in playbooks. It can also be executed directly by /usr/bin/ansible to check what variables are available
in playbooks. It can also be executed directly by /usr/bin/ansible to check what variables are available
to a host.</p>
to a host.</p>
@ -1744,7 +1834,7 @@ on your remote systems.</p>
</div>
</div>
</div>
</div>
<divclass="section"id="shell">
<divclass="section"id="shell">
<spanid="id28"></span><h2><aclass="toc-backref"href="#contents">shell</a><aclass="headerlink"href="#shell"title="Permalink to this headline">¶</a></h2>
<spanid="id30"></span><h2><aclass="toc-backref"href="#contents">shell</a><aclass="headerlink"href="#shell"title="Permalink to this headline">¶</a></h2>
<p>The shell module takes the command name followed by a list of
<p>The shell module takes the command name followed by a list of
arguments, space delimited. It is almost exactly like the command module
arguments, space delimited. It is almost exactly like the command module
but runs the command through the user’s configured shell on the remote node.</p>
but runs the command through the user’s configured shell on the remote node.</p>
@ -1794,7 +1884,7 @@ your best judgement.</p>
</div>
</div>
</div>
</div>
<divclass="section"id="subversion">
<divclass="section"id="subversion">
<spanid="id29"></span><h2><aclass="toc-backref"href="#contents">subversion</a><aclass="headerlink"href="#subversion"title="Permalink to this headline">¶</a></h2>
<spanid="id31"></span><h2><aclass="toc-backref"href="#contents">subversion</a><aclass="headerlink"href="#subversion"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Deploys a subversion repository.</p>
<p>Deploys a subversion repository.</p>
@ -1836,7 +1926,7 @@ discarded. If no, this module will fail if it encounters modified files.</td>
</div>
</div>
</div>
</div>
<divclass="section"id="supervisorctl">
<divclass="section"id="supervisorctl">
<spanid="id30"></span><h2><aclass="toc-backref"href="#contents">supervisorctl</a><aclass="headerlink"href="#supervisorctl"title="Permalink to this headline">¶</a></h2>
<spanid="id32"></span><h2><aclass="toc-backref"href="#contents">supervisorctl</a><aclass="headerlink"href="#supervisorctl"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Manage the state of a program or group of programs running via Supervisord</p>
<p>Manage the state of a program or group of programs running via Supervisord</p>
@ -1872,7 +1962,7 @@ discarded. If no, this module will fail if it encounters modified files.</td>
</div>
</div>
</div>
</div>
<divclass="section"id="template">
<divclass="section"id="template">
<spanid="id31"></span><h2><aclass="toc-backref"href="#contents">template</a><aclass="headerlink"href="#template"title="Permalink to this headline">¶</a></h2>
<spanid="id33"></span><h2><aclass="toc-backref"href="#contents">template</a><aclass="headerlink"href="#template"title="Permalink to this headline">¶</a></h2>
<p>Templates a file out to a remote server.</p>
<p>Templates a file out to a remote server.</p>
<tableborder="1"class="docutils">
<tableborder="1"class="docutils">
<colgroup>
<colgroup>
@ -1912,7 +2002,7 @@ a relative or absolute path.</td>
</div>
</div>
</div>
</div>
<divclass="section"id="user">
<divclass="section"id="user">
<spanid="id32"></span><h2><aclass="toc-backref"href="#contents">user</a><aclass="headerlink"href="#user"title="Permalink to this headline">¶</a></h2>
<spanid="id34"></span><h2><aclass="toc-backref"href="#contents">user</a><aclass="headerlink"href="#user"title="Permalink to this headline">¶</a></h2>
<p>Creates user accounts, manipulates existing user accounts, and removes user accounts.</p>
<p>Creates user accounts, manipulates existing user accounts, and removes user accounts.</p>
<tableborder="1"class="docutils">
<tableborder="1"class="docutils">
<colgroup>
<colgroup>
@ -2010,8 +2100,63 @@ user name=mdehaan groups=wheel,skynet
user name=mdehaan state=absent force=yes</pre>
user name=mdehaan state=absent force=yes</pre>
</div>
</div>
</div>
</div>
<divclass="section"id="wait-for">
<spanid="id35"></span><h2><aclass="toc-backref"href="#contents">wait_for</a><aclass="headerlink"href="#wait-for"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Waits for a given port to become accessible (or inaccessible) on a local or remote server.</p>
<p>This is useful for when services are not immediately available after their init scripts return – which is true of certain
Java application servers. It is also useful when starting guests with the virt module and
needing to pause until they are ready.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="17%"/>
<colwidth="9%"/>
<colwidth="9%"/>
<colwidth="65%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>host</td>
<td>no</td>
<td>127.0.0.1</td>
<td>hostname or IP to wait for</td>
</tr>
<trclass="row-odd"><td>timeout</td>
<td>no</td>
<td>300</td>
<td>maximum number of seconds to wait</td>
</tr>
<trclass="row-even"><td>delay</td>
<td>no</td>
<td>0</td>
<td>number of seconds to wait before starting to poll</td>
</tr>
<trclass="row-odd"><td>port</td>
<td>yes</td>
<td> </td>
<td>port to poll for openness or closedness</td>
</tr>
<trclass="row-even"><td>state</td>
<td>no</td>
<td>started</td>
<td>either ‘started’, or ‘stopped’ depending on whether the module should poll
for the port being open or closed.</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
Michael DeHaan
12 years ago