Add yum module to examples + playbook examples

html/examples.html

@@ -130,6 +130,7 @@ s.parentNode.insertBefore(ga, s);
 <li><a class="reference internal" href="#">Command Line Examples</a><ul>
 <li><a class="reference internal" href="#parallelism-and-shell-commands">Parallelism and Shell Commands</a></li>
 <li><a class="reference internal" href="#file-transfer-templating">File Transfer &amp; Templating</a></li>
+<li><a class="reference internal" href="#managing-packages">Managing Packages</a></li>
 <li><a class="reference internal" href="#deploying-from-source-control">Deploying From Source Control</a></li>
 <li><a class="reference internal" href="#managing-services">Managing Services</a></li>
 <li><a class="reference internal" href="#time-limited-background-operations">Time Limited Background Operations</a></li>
@@ -224,6 +225,24 @@ ansible webservers -m template -a "src=/srv/ntp.j2 dest=/etc/ntp.conf"</pre>
 installed, data from these projects will also be made available to the
 template engine, using &#8216;facter&#8217; and &#8216;ohai&#8217; prefixes for each.</p>
 </div>
+<div class="section" id="managing-packages">
+<h2>Managing Packages<a class="headerlink" href="#managing-packages" title="Permalink to this headline">¶</a></h2>
+<p>Ensure a package is installed, but don&#8217;t update it:</p>
+<div class="highlight-python"><pre>ansible webservers -m yum -a "pkg=acme state=installed"</pre>
+</div>
+<p>Ensure a package is installed to a specific version:</p>
+<div class="highlight-python"><pre>ansible-webservers -m yum -a "pkg=acme-1.5 state=installed"</pre>
+</div>
+<p>Ensure a package is at the latest version:</p>
+<div class="highlight-python"><pre>ansible webservers -m yum -a "pkg=acme state=latest"</pre>
+</div>
+<p>Ensure a package is not installed:</p>
+<blockquote>
+<div>ansible-webservers -m yum -a &#8220;pkg=acme state=removed&#8221;</div></blockquote>
+<p>Currently Ansible only has a module for managing packages with yum.  You can install
+for other package manages using the command module or contribute a module
+for other package managers.  Stop by the mailing list for info/details.</p>
+</div>
 <div class="section" id="deploying-from-source-control">
 <h2>Deploying From Source Control<a class="headerlink" href="#deploying-from-source-control" title="Permalink to this headline">¶</a></h2>
 <p>Deploy your webapp straight from git:</p>
@@ -237,10 +256,13 @@ directly from git and then restarting apache.</p>
 <div class="section" id="managing-services">
 <h2>Managing Services<a class="headerlink" href="#managing-services" title="Permalink to this headline">¶</a></h2>
 <p>Ensure a service is started on all webservers:</p>
-<div class="highlight-python"><pre>ansible webservers -m service name=httpd state=started</pre>
+<div class="highlight-python"><pre>ansible webservers -m service -a "name=httpd state=started"</pre>
 </div>
 <p>Alternatively, restart a service on all webservers:</p>
-<div class="highlight-python"><pre>ansible webservers -m service name=httpd state=restarted</pre>
+<div class="highlight-python"><pre>ansible webservers -m service -a "name=httpd state=restarted"</pre>
+</div>
+<p>Ensure a service is stopped:</p>
+<div class="highlight-python"><pre>ansible webservers -m service -a "name=httpd state=stopped"</pre>
 </div>
 </div>
 <div class="section" id="time-limited-background-operations">

html/index.html

@@ -247,6 +247,7 @@ you with questions about Ansible.</p>
 <li class="toctree-l1"><a class="reference internal" href="examples.html">Command Line Examples</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="examples.html#parallelism-and-shell-commands">Parallelism and Shell Commands</a></li>
 <li class="toctree-l2"><a class="reference internal" href="examples.html#file-transfer-templating">File Transfer &amp; Templating</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples.html#managing-packages">Managing Packages</a></li>
 <li class="toctree-l2"><a class="reference internal" href="examples.html#deploying-from-source-control">Deploying From Source Control</a></li>
 <li class="toctree-l2"><a class="reference internal" href="examples.html#managing-services">Managing Services</a></li>
 <li class="toctree-l2"><a class="reference internal" href="examples.html#time-limited-background-operations">Time Limited Background Operations</a></li>

html/man/ansible-playbook.1.html

@@ -1,6 +1,6 @@
 <?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>ansible-playbook</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-playbook" lang="en"><a id="id358804"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — run an ansible playbook</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible-playbook &lt;filename.yml&gt; … [options]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible playbooks</strong></span> are a configuration and multinode deployment system.  Ansible-playbook is the tool
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-playbook</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-playbook" lang="en"><a id="id440588"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — run an ansible playbook</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible-playbook &lt;filename.yml&gt; … [options]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible playbooks</strong></span> are a configuration and multinode deployment system.  Ansible-playbook is the tool
 used to run them.   See the project home page (link below) for more information.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
 <span class="strong"><strong>filename.yml</strong></span>
 </span></dt><dd>

html/man/ansible.1.html

@@ -1,6 +1,6 @@
 <?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>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id527251"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible &lt;host-pattern&gt; [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id413211"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible &lt;host-pattern&gt; [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
 SSH.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
 <span class="strong"><strong>host-pattern</strong></span>
 </span></dt><dd>

html/playbooks.html

@@ -216,6 +216,8 @@ server group, then more commands back on the webservers group, etc:</p>
   user: root
   tasks:
   - include: base.yml somevar=3 othervar=4
+  - name: ensure apache is installed
+    action: yum pkg=httpd state=installed
   - name: write the apache config file
     action: template src=/srv/httpd.j2 dest=/etc/httpd.conf
     notify:

rst/examples.rst

@@ -60,10 +60,6 @@ template engine, using 'facter' and 'ohai' prefixes for each.
 Managing Packages
 `````````````````
 
-Ensure a package is at the latest version::
-
-    ansible webservers -m yum -a "pkg=acme state=latest"
-
 Ensure a package is installed, but don't update it::
     
     ansible webservers -m yum -a "pkg=acme state=installed"
@@ -72,6 +68,10 @@ Ensure a package is installed to a specific version::
 
     ansible-webservers -m yum -a "pkg=acme-1.5 state=installed"
 
+Ensure a package is at the latest version::
+
+    ansible webservers -m yum -a "pkg=acme state=latest" 
+
 Ensure a package is not installed:
     
     ansible-webservers -m yum -a "pkg=acme state=removed"

rst/playbooks.rst

@@ -42,6 +42,8 @@ server group, then more commands back on the webservers group, etc::
       user: root
       tasks:
       - include: base.yml somevar=3 othervar=4
+      - name: ensure apache is installed
+        action: yum pkg=httpd state=installed
       - name: write the apache config file
         action: template src=/srv/httpd.j2 dest=/etc/httpd.conf
         notify: