From a13def0fbe4c107a3e1d14948b715cd77c223e94 Mon Sep 17 00:00:00 2001
From: Michael DeHaan <michael.dehaan@gmail.com>
Date: Sat, 10 Mar 2012 11:40:49 -0500
Subject: [PATCH] Add yum module to examples + playbook examples

---
 html/examples.html               | 26 ++++++++++++++++++++++++--
 html/index.html                  |  1 +
 html/man/ansible-playbook.1.html |  2 +-
 html/man/ansible.1.html          |  2 +-
 html/playbooks.html              |  2 ++
 html/searchindex.js              |  2 +-
 rst/examples.rst                 |  8 ++++----
 rst/playbooks.rst                |  2 ++
 8 files changed, 36 insertions(+), 9 deletions(-)

diff --git a/html/examples.html b/html/examples.html
index 0d2fd9313c..93cdf5fa39 100644
--- a/html/examples.html
+++ b/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">
diff --git a/html/index.html b/html/index.html
index b8f47ac610..733adba197 100644
--- a/html/index.html
+++ b/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>
diff --git a/html/man/ansible-playbook.1.html b/html/man/ansible-playbook.1.html
index b06617cd30..5f780064bf 100644
--- a/html/man/ansible-playbook.1.html
+++ b/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>
diff --git a/html/man/ansible.1.html b/html/man/ansible.1.html
index a6efe9517b..f1de964e8d 100644
--- a/html/man/ansible.1.html
+++ b/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>
diff --git a/html/playbooks.html b/html/playbooks.html
index d57a4bfcf9..60aa04072f 100644
--- a/html/playbooks.html
+++ b/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:
diff --git a/html/searchindex.js b/html/searchindex.js
index c9361ead01..0c27ffd724 100644
--- a/html/searchindex.js
+++ b/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({objects:{},terms:{all:[0,1,2,3,4,5,6,7,8],code:[1,2,3,8],mcollect:1,consum:2,pluggabl:2,invent:[],prefix:[3,4,8],concept:8,abil:2,follow:[2,3,4,6,7,8],scp:8,bubbl:[3,4],decid:2,middl:4,depend:2,secur:2,graph:2,sorri:[],elsewher:8,readabl:[],program:[1,2,3,4],selinux:4,larg:2,blindingli:1,spec:4,introduc:1,"case":2,sourc:[1,2,3,4,7,8],everi:[5,4],string:3,without:2,fals:[5,3],multi:[1,2,4],mechan:[],difficult:2,failur:[7,2,3],veri:[7,1,2,4],affect:4,implicitli:2,magic:2,level:[5,3,4],id_rsa:[0,8],list:[1,2,3,4,5,6,8,9],"try":2,item:[5,7],sane:2,form:[5,4],team:2,dotnet:5,saltstack:1,spent:2,straight:8,librari:[],pkg:3,pleas:2,alic:4,natur:3,seper:2,direct:2,batch:2,chef:[1,2],second:[5,8],design:[1,2],pass:[3,4],download:[0,1],further:4,submit:2,port:[2,8],even:[2,8],what:[0,2,3,4,1],insid:4,compar:2,favcolor:[4,8],fine:2,section:[1,3,4],abl:[],current:2,abbrevi:5,version:[3,8],suspect:2,"new":2,net:2,varnam:4,ever:1,method:7,told:4,xml:[],hasn:2,hash:3,abov:4,conf:[4,8],eckersberg:[5,2],gener:[2,4],never:2,here:[1,3,4,8],shouldn:2,let:[2,4,8],pub:8,address:[6,2,3],path:3,sinc:8,valu:[5,3,4],box:[1,3],great:[1,2],tire:2,ahead:4,precursor:1,technolog:1,step:[2,3,4],adopt:2,prior:3,pick:[5,2,8],action:[1,3,4],extrem:0,implement:7,commonli:8,ourselv:4,employe:5,via:[0,1],regardless:[5,1,2,4],extra:[2,4],solut:2,modul:[0,1,2,3,4,7,8],releas:[0,2],unix:[2,4],"boolean":5,instal:[0,1,2,3,4,8],select:[1,3,4,6],httpd:[4,8],from:[0,1,2,3,4,5,8],describ:[3,4],would:[3,8],commun:2,"super":1,visit:1,two:[5,0,6],noarch:0,live:0,handler:[1,4,8],call:3,usr:[7,3,4,8],handl:2,msg:[7,3],suppos:4,checkout:[2,3],tell:[3,4,8],more:[0,1,2,3,4,6],sort:2,flat:4,desir:4,idempot:[2,3,4,8],comparison:[1,2],unneccessari:[],sshd:1,notic:2,train:2,agent:[0,8],particular:[1,4],central:2,compani:2,easiest:1,starter:[],must:[5,3,4],none:7,join:1,ibm:1,module_arg:7,dest:[3,4,8],setup:[1,3,8],work:[0,1,2,4,6,8],knows_oop:5,dev:2,remain:1,minimum:4,can:[0,1,2,3,4,5,6,7,8],erb:2,learn:[6,0,2,4,1],about:[0,1,2,3,4,5],purpos:3,root:[5,1,4],control:[1,3,4,8],want:[7,2,3,4,8],tar:0,process:[1,2,8],rpath:1,sudo:0,share:3,templat:[0,1,2,3,4,8],high:[],critic:1,tag:[0,3],explor:0,occur:4,nearli:[3,4],alwai:[2,3],cours:2,multipl:[6,2,4,8],newlin:5,thoug:[],lame:5,capistrano:[1,2],anoth:2,ping:[0,7,3,1],uptim:7,write:[1,2,3,4,5,8],how:[0,1,2,3,4,5,6,7,8],anyon:2,pure:[],instead:[2,3],simpl:[1,2,4,5,7,8],updat:[3,8],map:4,product:[],financ:1,resourc:[1,2],referenc:[6,4],clone:0,after:[2,4,8],usabl:[1,4],befor:[2,3,4],ohai_:[3,4],mai:[5,0,2,7],end:[2,3,4],suck:[],data:[5,2,3,8,7],parallel:[1,2,8],man:[1,9],"short":[1,2],orchestr:[1,2,4],practic:2,bootstrap:[1,2],favorit:1,element:[5,3],issu:[1,2],inform:[7,3,4],mango:5,combin:5,allow:[2,4],order:[2,4],talk:[0,4],oper:[1,8],help:1,xmpp:2,over:[1,8],move:[3,4],orang:5,mission:1,elit:5,rpmbuild:0,comma:5,hierarchi:2,effici:2,suffer:2,mainli:2,paramet:[3,4],facter_:[3,4],jid:8,overlord:0,group:[1,7,4,6],cli:7,taboot:2,better:[],yaml:[5,1,2,4],pend:[4,8],rapidli:7,infrastructur:[6,0,2,4,1],mail:[1,2,6],job_statu:8,main:4,might:4,easier:2,wouldn:2,them:[2,3,4,8],good:2,"return":[7,1,2,3],hop:2,thei:[7,2,3,4,8],food:5,dai:2,scene:3,framework:[7,1,2],jinja2:[0,2,3,4,8],half:2,now:[0,2,3],discuss:2,nor:3,choic:1,multiprocess:[0,2],vidal:2,name:[5,1,3,4,8],anyth:[2,3],neccessari:[],config:[1,4],drop:3,datastructur:7,separ:[5,4],easili:[],mode:2,each:[5,2,3,4,8],found:7,stock:3,spend:2,mean:[2,3,4],harm:4,mental:2,due:2,michael:1,individu:6,hard:2,idea:[1,2],realli:[5,2,3,4],contributor:[],backport:0,facter:[1,2,3,4,8],our:5,happen:[2,3,4],event:[2,3],special:[],out:[1,2,3,4,5,7,8],variabl:[2,3,4,8],cefengin:[],network:1,space:[1,3],bserver:0,reboot:8,content:[0,2,1],adapt:2,rel:3,internet:1,print:7,got:2,correct:[5,1,2,4],red:[1,2,8],integr:[],painless:1,barrier:[],advanc:[7,2],ntp:8,given:[2,3,8],free:[],someon:[],small:[],reason:2,base:[1,2,4],lab:[1,2],dictionari:5,put:[0,8],org:0,bash:[0,2,8],basi:4,pyyaml:0,sytem:2,indent:5,could:[7,4],ask:[1,2],fqdn:8,thing:[1,2,4],place:1,isn:[1,2],adrian:2,retain:2,assign:[1,4],frequent:[1,2],first:[0,1,2,3,4,8],origin:1,softwar:[1,2,3,8],rang:1,notifi:[1,2,4,8],directli:[3,4,8],onc:[2,3,4],number:3,yourself:0,hook:3,instruct:[0,2],alreadi:[0,2,3,4],puppet:[1,2],least:[],extend:[1,2],massiv:1,open:2,differ:[8,0,2,4,1],amqp:[],convent:3,script:[7,1,2,8],associ:5,top:[2,3,4],mkdir:4,system:[0,1,2,3,4,6,8],construct:[7,2],grow:[],inventori:[0,6,3,4,1],too:[1,2],statement:[1,4],which:[5,0,6,4,1],gather:2,zeromq:[],john:[5,2],"final":5,iptabl:4,shell:[1,3,8],option:[5,7,4,9,8],especi:2,tool:[1,2,3,7,8,9],copi:[1,3,8],took:2,specifi:[5,2,3,8],retyp:0,bcfg2:[],pars:2,domin:[],than:[0,1,2,3,4,8],wide:2,liter:3,silli:4,target:[1,6],keyword:2,provid:5,remov:3,richer:2,structur:5,banana:5,project:[0,2,8,1],inquir:[],reus:4,architect:1,were:[2,4],tion:[],uses_cv:5,provis:2,pre:0,sai:[2,4],fashion:2,comput:[],runner:7,explicit:3,mind:2,ani:[1,2,3,4,7,8],seth:2,sysadmin:2,packag:[2,3],have:[0,2,4,1],need:[0,2,3,4,5,8],seem:2,cfengin:2,seek:3,paramiko:0,sat:2,imagin:4,engin:8,built:[0,2],veteran:[],contact:[7,0,2,3],note:[6,3,4,8],also:[0,1,2,3,4,5,6,7,8],ideal:[1,2],client:1,build:[7,0,2],indic:3,datacent:4,divers:1,singl:2,begin:5,unless:3,distribut:[0,2,1],deploy:[1,2,4,8],track:8,who:[],reach:1,deleg:2,discov:4,most:[5,2,3],plai:[3,4],regular:4,plan:2,deploi:[1,2,3,4,8],pair:3,why:1,prove:[],don:[2,3],doc:1,later:8,cover:[2,8],doe:[1,2,3,6],meanwhil:2,bracket:[5,6],snapshot:3,yum:[1,3],wildcard:6,databas:4,salt:[],awesom:[1,4],think:2,show:[4,8],cheat:2,text:2,verbos:3,syntax:[5,2,4],bring:4,raleigh:1,particularli:4,playbook:[0,1,2,3,4,5,6,7,8,9],hack:1,radic:1,identifi:2,trivial:[1,3],find:2,rotat:4,involv:[],absolut:3,onli:[0,2,3,4,8],explicitli:4,locat:3,acquir:[],pretti:[7,2],configur:[0,1,2,3,4,5,6,8],apach:[2,4,8],behind:[2,3],should:[5,2,3],somevar:4,freenod:1,local:3,yml:4,custom:2,long_running_oper:8,contribut:1,variou:[2,3],get:[0,1,2,4,5,8],express:[5,1,7,4],stop:[3,4],kind:2,autom:2,repo:[3,8],ssl:2,obviou:1,ssh:[0,2,8,1],requir:[0,2,3,1],uvh:0,experi:2,bar:6,patch:2,sha:3,stuff:8,common:4,contain:[2,3,4],through:[0,3,1],where:[1,2,3,4],view:[1,9],set:[0,2,3,4],hierachi:2,still:2,roadmap:[],see:[0,1,3,4,5,6,8,9],result:[7,3],fail:[7,2,4],charact:5,becaus:2,ntp_server:8,best:[2,4],page:[5,0,2,9,1],planet:1,statu:8,wire:[],manpag:0,expert:2,pattern:[1,7,4,6],someth:[1,2,3,8],discoveri:3,restart:[2,3,4,8],state:[2,3,4,8],won:8,between:[5,2,4],"import":7,irc:1,across:2,attribut:3,altern:8,solo:2,kei:[5,0,3,4],style:3,extens:[1,2],job:[5,8],entir:[2,4],aserv:0,pull:2,webapp:[2,8],asdescrib:[],minut:2,addit:[5,1,4],both:2,j2ee:[],delimit:3,goal:1,howev:2,equal:2,against:[1,2,4,6],etc:[0,1,2,4,6,8],instanc:4,logic:4,mani:[4,8],com:[0,7,4,6],among:2,assur:4,simpli:[3,4],author:1,figur:2,overview:5,inspir:[1,2],header:6,written:[1,3,4,8],colon:4,shutdown:3,linux:[1,2,4],poll:[1,4,8],rpm:[0,1],coupl:2,platform:2,multiplay:1,three:6,been:[1,2],timmi:4,json:[7,1,2,3],much:[1,2,3],treat:2,interest:[],basic:[0,1,2,3,5,6],quickli:[5,1],indenta:[],rather:2,fire:[1,2],rubi:[5,2,3,8],argument:3,likes_emac:5,func:[1,2],atlanta:[4,8],those:[5,2,3],statist:[],emploi:5,authorized_kei:0,exception:2,look:[6,4,8],replac:4,hoc:[1,2,4,8],servic:[1,3,4,8],md5sum:3,straighten:2,defin:4,"while":[2,4],kick:2,facter_hostnam:4,error:2,cobbler:[1,2],dehaan:1,layer:2,motd:[4,8],max_client:4,stdout:7,almost:2,likin:2,site:[2,9],believ:2,dag:2,myapp:8,module_nam:7,sever:[5,2],http_port:4,develop:[5,0,2,1],welcom:1,minim:0,perform:2,impact:2,make:[0,2,3,4,8],ohai:[1,2,3,4,8],cross:2,same:[5,6,8],member:5,python:[0,1,2,3,5,7,8],complex:[1,2,4],success:3,document:[7,0,2,4,8],ansibl:[0,1,2,3,4,5,6,7,8,9],complet:[0,2,4],http:3,hostnam:[7,4],again:[2,4],nest:3,permit:5,rail:2,effect:4,remot:[0,3,4,8],fruit:5,user:[2,4],php:8,distutil:[0,1],typic:[2,8],tune:2,recent:2,lower:2,appropri:2,off:[1,2],scenario:3,mention:4,setenforc:4,compos:4,well:[0,2,3,4],hypothet:4,non:1,exampl:[0,1,2,3,4,5,6,7,8,9],command:[0,1,2,3,4,6,7,8,9],thi:[0,1,2,3,4,5,6,8],choos:3,programm:[7,2],dereferenc:4,usual:4,next:4,protocol:3,entri:[],just:[0,1,2,3,4,8],less:[0,2,1],excel:[1,2],rest:9,kill:8,human:[],heavili:2,skill:5,simultan:8,languag:[0,1,2,3,5,6],web:[7,2,8,9],versu:1,easi:[1,2,3],mix:6,trigger:[2,3],except:4,littl:[1,2],add:[0,2,8],notori:2,els:1,unlik:[2,4],hat:[1,2],app:2,match:4,take:[2,3],bin:[0,7,3,4,8],applic:[7,2,4],around:2,format:[0,1,2,3,4,5,6,8],read:[5,0,7],term:[],fast:1,dark:7,game:1,know:[5,2,3,4],background:[1,8],world:[0,2],bit:[2,3],password:0,licens:[],daemon:[1,2],motorola:1,like:[2,3,4,5,6,8],specif:[6,7,4,8],distil:2,corpor:[],signal:[2,4],arbitrari:2,manual:2,integ:3,noth:4,edit:0,api:[7,1,2,3],necessari:[3,8],either:[2,3],lose:8,popular:1,output:[2,4],unnecessari:3,stdin:[],shed:2,didn:2,often:2,twitter:[],suppli:3,some:[0,2,3,1],back:[2,4],dead:1,born:2,heritag:2,server:[1,2,3,4,8],transport:[1,2],tmp:[4,8],render:3,lead:2,assum:4,avoid:[0,2,3],though:[1,2,3],definit:4,thank:2,per:7,tracker:1,exit:7,cloud:2,foo:[6,8],complic:[1,2],webserv:[6,4,8],refer:8,machin:[0,2,3,4,8],core:[1,2],encourag:2,yamllint:5,run:[0,2,3,4,7,8],itself:7,power:[7,1,2],usag:[3,8],devop:1,web2:7,host:[0,1,2,3,4,6,7,8],web1:7,promot:2,repositori:0,async:2,meantim:2,major:[],appli:2,task:[1,2,4,8],simpler:[2,8],src:[3,4,8],sbin:[3,4,8],actual:[2,3],gplv3:[],othervar:4,surround:5,manag:[0,1,2,3,4,5,6,8],kept:[2,4],srv:[4,8],messag:[7,2],done:[2,4],industri:1,own:[1,2,3,4],real:0,bounc:3,within:[2,3],contriv:4,sneaker:2,automat:3,upgrad:[3,8],down:7,bsd:2,multinod:2,ensur:[2,4,8],chang:[3,4,8],perl:8,soon:2,your:[0,1,2,3,4,5,6,8],merg:2,git:[0,2,3,8,1],type:[7,2],fabric:[1,2],wai:[5,0,2,4,8],aren:2,transfer:[1,8],execut:[7,1,2,3,4],support:[1,2,3,8],question:[1,2],"long":[1,2,3,8],happi:1,avail:[0,2,3,4,7,8,9],start:[0,1,2,3,4,5,8],appl:5,wordpress:4,includ:[1,3,4],lot:[1,4,8],suit:[2,4],"var":[1,4],laserllama:1,fork:[7,2],head:[3,8],simplejson:0,enough:2,lint:5,yeah:4,github:[0,1],taken:[2,4],line:[0,1,2,3,4,5,6,7,8,9],"true":[5,3,4],congratul:0,info:4,strawberri:5,"throw":2,made:[2,3,8],possibl:[6,4,8],whether:[7,2],wish:[5,0,7,2,6],caller:3,until:0,asynchron:[1,4],record:5,limit:[1,8],rerun:4,otherwis:3,problem:2,similar:3,email:1,chip:1,curv:[1,2],featur:[2,4],tasti:5,creat:[1,2],certain:[2,4],"abstract":[],doesn:1,repres:5,strongli:2,exist:[1,4],file:[0,1,3,4,5,6,8],bob:4,ship:3,check:[2,3,8],probabl:2,echo:0,denot:6,coder:2,googl:1,dbserver:[6,4],when:[2,3,4,8],detail:[1,7],"default":[1,2,6],nich:[],other:[0,1,2,3,4,8],futur:0,varieti:2,test:[0,2,3],squar:5,you:[0,1,2,3,4,5,6,8],architectur:2,node:[0,2,3,8,1],contend:2,notif:2,intend:[],clean:2,sequenc:1,"class":[1,4],asciidoc:0,push:[2,4],scale:[1,2],intent:2,log:4,deferenc:4,gap:2,"60k":[1,2],stai:2,sphinx:0,amp:0,soap:[],directori:[3,4],reliabl:2,portion:6,emerg:1,fact:[],potenti:4,time:[0,1,2,3,4,6,8],far:1,hello:0},objtypes:{},titles:["Downloads &amp; Getting Started","Introducing Ansible","Frequently Asked Questions","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","faq","modules","playbooks","YAMLScripts","patterns","api","examples","man"]})
\ No newline at end of file
+Search.setIndex({objects:{},terms:{all:[0,1,2,3,4,5,6,7,8],concept:8,wire:[],myapp:8,perl:8,mcollect:1,consum:2,pluggabl:2,invent:[],prefix:[3,4,8],code:[1,2,3,8],upgrad:[3,8],abil:2,follow:[2,3,4,6,7,8],scp:8,content:[0,2,1],decid:2,middl:4,depend:2,secur:2,git:[0,2,3,8,1],graph:2,sorri:[],elsewher:8,readabl:[],specif:[6,7,4,8],program:[1,2,3,4],selinux:4,exit:7,blindingli:1,spec:4,introduc:1,emploi:5,sourc:[1,2,3,4,7,8],everi:[5,4],string:3,fals:[5,3],exception:2,mechan:[],whether:[7,2],failur:[7,2,3],veri:[7,1,2,4],affect:4,implicitli:2,magic:2,level:[5,3,4],id_rsa:[0,8],list:[1,2,3,4,5,6,8,9],"try":2,item:[5,7],sane:2,team:2,dotnet:5,saltstack:1,servic:[1,3,4,8],playbook:[0,1,2,3,4,5,6,7,8,9],pleas:2,alic:4,natur:3,seper:2,direct:2,straighten:2,chef:[1,2],second:[5,8],design:[1,2],pass:[3,4],download:[0,1],further:4,port:[2,8],even:[2,8],what:[0,2,3,4,1],insid:4,compar:2,favcolor:[4,8],trivial:[1,3],section:[1,3,4],abl:[],current:[2,8],abbrevi:5,version:[3,8],suspect:2,"new":2,net:2,varnam:4,ever:1,method:7,told:4,involv:[],hasn:2,hash:3,facter_hostnam:4,eckersberg:[5,2],gener:[2,4],never:2,here:[1,3,4,8],shouldn:2,let:[2,4,8],free:[],address:[6,2,3],path:3,sinc:8,valu:[5,3,4],box:[1,3],great:[1,2],pretti:[7,2],ahead:4,precursor:1,technolog:1,host:[0,1,2,3,4,6,7,8],later:8,prior:3,pick:[5,2,8],action:[1,3,4],extrem:0,implement:7,commonli:8,ourselv:4,employe:5,via:[0,1],regardless:[5,1,2,4],extra:[2,4],apach:[2,4,8],modul:[0,1,2,3,4,7,8],put:[0,8],unix:[2,4],"boolean":5,instal:[0,1,2,3,4,8],select:[1,3,4,6],httpd:[4,8],from:[0,1,2,3,4,5,8],describ:[3,4],would:[3,8],commun:2,"super":1,visit:1,two:[5,0,6],noarch:0,suit:[2,4],live:0,handler:[1,4,8],call:3,usr:[7,3,4,8],msg:[7,3],somevar:4,checkout:[2,3],tell:[3,4,8],more:[0,1,2,3,4,6],sort:2,flat:4,desir:4,idempot:[2,3,4,8],src:[3,4,8],python:[0,1,2,3,5,7,8],unneccessari:[],sshd:1,notic:2,train:2,agent:[0,8],particular:[1,4],actual:[2,3],compani:2,easiest:1,starter:[],must:[5,3,4],none:7,join:1,ibm:1,module_arg:7,setup:[1,3,8],work:[0,1,2,4,6,8],knows_oop:5,dev:2,remain:1,minimum:4,can:[0,1,2,3,4,5,6,7,8],erb:2,learn:[6,0,2,4,1],about:[0,1,2,3,4,5],purpos:3,root:[5,1,4],control:[1,3,4,8],gplv3:[],want:[7,2,3,4,8],tar:0,process:[1,2,8],rpath:1,sudo:0,share:3,templat:[0,1,2,3,4,8],high:[],critic:1,tag:[0,3],surround:5,explor:0,occur:4,contribut:[1,8],alwai:[2,3],cours:2,multipl:[6,2,4,8],newlin:5,thoug:[],lame:5,capistrano:[1,2],anoth:2,ping:[0,7,3,1],uptim:7,write:[1,2,3,4,5,8],how:[0,1,2,3,4,5,6,7,8],anyon:2,pure:[],instead:[2,3],config:[1,4],stock:3,map:4,product:[],express:[5,1,7,4],resourc:[1,2],referenc:[6,4],clone:0,after:[2,4,8],usabl:[1,4],befor:[2,3,4],ohai_:[3,4],mai:[5,0,2,7],end:[2,3,4],suck:[],data:[5,2,3,8,7],parallel:[1,2,8],man:[1,9],"short":[1,2],orchestr:[1,2,4],practic:2,read:[5,0,7],bootstrap:[1,2],favorit:1,element:[5,3],issu:[1,2],inform:[7,3,4],mango:5,combin:5,allow:[2,4],order:[2,4],talk:[0,4],origin:1,help:1,portion:6,xmpp:2,over:[1,8],move:[3,4],orang:5,mission:1,elit:5,rpmbuild:0,comma:5,hierarchi:2,suffer:2,mainli:2,paramet:[3,4],facter_:[3,4],jid:8,overlord:0,group:[1,7,4,6],cli:7,taboot:2,better:[],yaml:[5,1,2,4],pend:[4,8],rapidli:7,infrastructur:[6,0,2,4,1],bin:[0,7,3,4,8],mail:[1,2,8,6],job_statu:8,main:4,might:4,easier:2,wouldn:2,them:[2,3,4,8],good:2,"return":[7,1,2,3],hop:2,thei:[7,2,3,4,8],food:5,dai:2,number:3,framework:[7,1,2],jinja2:[0,2,3,4,8],half:2,now:[0,2,3],discuss:2,nor:3,choic:1,multiprocess:[0,2],vidal:2,name:[5,1,3,4,8],anyth:[2,3],neccessari:[],simpl:[1,2,4,5,7,8],drop:3,instruct:[0,2],separ:[5,4],easili:[],exampl:[0,1,2,3,4,5,6,7,8,9],mode:2,each:[5,2,3,4,8],found:7,updat:[3,8],mean:[2,3,4],harm:4,mental:2,michael:1,individu:6,hard:2,idea:[1,2],realli:[5,2,3,4],ensur:[2,4,8],backport:0,facter:[1,2,3,4,8],our:5,happen:[2,3,4],event:[2,3],special:[],out:[1,2,3,4,5,7,8],variabl:[2,3,4,8],network:1,space:[1,3],reboot:8,bubbl:[3,4],adapt:2,rel:3,internet:1,print:7,got:2,correct:[5,1,2,4],red:[1,2,8],common:4,barrier:[],advanc:[7,2],ntp:8,differ:[8,0,2,4,1],pub:8,effect:4,small:[],reason:2,base:[1,2,4],lab:[1,2],dictionari:5,releas:[0,2],org:0,featur:[2,4],bash:[0,2,8],basi:4,pyyaml:0,sytem:2,indent:5,could:[7,4],ask:[1,2],fqdn:8,thing:[1,2,4],place:1,isn:[1,2],adrian:2,retain:2,assign:[1,4],frequent:[1,2],first:[0,1,2,3,4,8],oper:[1,8],softwar:[1,2,3,8],rang:1,notifi:[1,2,4,8],directli:[3,4,8],onc:[2,3,4],scene:3,yourself:0,hook:3,datastructur:7,alreadi:[0,2,3,4],puppet:[1,2],construct:[7,2],extend:[1,2],massiv:1,open:2,given:[2,3,8],"long":[1,2,3,8],convent:3,script:[7,1,2,8],associ:5,top:[2,3,4],mkdir:4,system:[0,1,2,3,4,6,8],least:[],grow:[],appl:5,too:[1,2],statement:[1,4],which:[5,0,6,4,1],zeromq:[],john:[5,2],"final":5,iptabl:4,shell:[1,3,8],option:[5,7,4,9,8],especi:2,welcom:1,tool:[1,2,3,7,8,9],copi:[1,3,8],took:2,specifi:[5,2,3,8],retyp:0,bcfg2:[],pars:2,domin:[],than:[0,1,2,3,4,8],wide:2,liter:3,silli:4,target:[1,6],keyword:2,provid:5,remov:[3,8],richer:2,structur:5,banana:5,project:[0,2,8,1],reus:4,architect:1,were:[2,4],tion:[],uses_cv:5,provis:2,pre:0,sai:[2,4],fashion:2,comput:[],runner:7,explicit:3,mind:2,ani:[1,2,3,4,7,8],hypothet:4,sysadmin:2,packag:[1,2,3,8],complet:[0,2,4],have:[0,2,4,1],need:[0,2,3,4,5,8],seem:2,cfengin:2,seek:3,well:[0,2,3,4],paramiko:0,sat:2,imagin:4,engin:8,built:[0,2],veteran:[],client:1,note:[6,3,4,8],also:[0,1,2,3,4,5,6,7,8],ideal:[1,2],contact:[7,0,2,3],build:[7,0,2],indic:3,datacent:4,divers:1,singl:2,happi:1,begin:5,unless:3,distribut:[0,2,1],deploy:[1,2,4,8],track:8,who:[],reach:1,deleg:2,discov:4,most:[5,2,3],plai:[3,4],regular:4,plan:2,deploi:[1,2,3,4,8],pair:3,why:1,strawberri:5,don:[2,3,8],wish:[5,0,7,2,6],doc:1,adopt:2,cover:[2,8],doe:[1,2,3,6],meanwhil:2,bracket:[5,6],snapshot:3,yum:[1,3,4,8],wildcard:6,pattern:[1,7,4,6],usual:4,salt:[],awesom:[1,4],think:2,show:[4,8],cheat:2,text:2,verbos:3,syntax:[5,2,4],bring:4,raleigh:1,particularli:4,pkg:[3,4,8],hack:1,radic:1,protocol:3,dereferenc:4,fine:2,find:2,rotat:4,xml:[],absolut:3,onli:[0,2,3,4,8],explicitli:4,locat:3,acquir:[],tire:2,configur:[0,1,2,3,4,5,6,8],solut:2,state:[2,3,4,8],should:[5,2,3],suppos:4,congratul:0,local:3,yml:4,long_running_oper:8,nearli:[3,4],variou:[2,3],get:[0,1,2,4,5,8],financ:1,stop:[3,4,8],kind:2,autom:2,repo:[3,8],ssl:2,obviou:1,ssh:[0,2,8,1],requir:[0,2,3,1],uvh:0,irc:1,bar:6,patch:2,sha:3,stuff:8,integr:[],contain:[2,3,4],through:[0,3,1],where:[1,2,3,4],view:[1,9],set:[0,2,3,4],hierachi:2,roadmap:[],see:[0,1,3,4,5,6,8,9],result:[7,3],fail:[7,2,4],charact:5,becaus:2,skill:5,best:[2,4],asynchron:[1,4],statu:8,still:2,kei:[5,0,3,4],expert:2,databas:4,someth:[1,2,3,8],discoveri:3,restart:[2,3,4,8],behind:[2,3],won:8,between:[5,2,4],"import":7,experi:2,across:2,attribut:3,altern:8,solo:2,manpag:0,style:3,extens:[1,2],job:[5,8],entir:[2,4],aserv:0,webapp:[2,8],asdescrib:[],minut:2,addit:[5,1,4],both:2,j2ee:[],delimit:3,goal:1,howev:2,equal:2,against:[1,2,4,6],etc:[0,1,2,4,6,8],instanc:4,logic:4,mani:[4,8],com:[0,7,4,6],among:2,assur:4,simpli:[3,4],figur:2,overview:5,inspir:[1,2],header:6,written:[1,3,4,8],colon:4,shutdown:3,linux:[1,2,4],poll:[1,4,8],rpm:[0,1],coupl:2,platform:2,multiplay:1,three:6,been:[1,2],timmi:4,json:[7,1,2,3],much:[1,2,3],treat:2,interest:[],basic:[0,1,2,3,5,6],futur:0,quickli:[5,1],indenta:[],rather:2,fire:[1,2],rubi:[5,2,3,8],argument:3,func:[1,2],minim:0,atlanta:[4,8],those:[5,2,3],statist:[],"case":2,authorized_kei:0,multi:[1,2,4],look:[6,4,8],hoc:[1,2,4,8],straight:8,md5sum:3,permit:5,batch:2,defin:4,"while":[2,4],match:4,abov:4,error:2,exist:[1,4],dehaan:1,layer:2,motd:[4,8],max_client:4,stdout:7,almost:2,likin:2,site:[2,9],believ:2,dag:2,conf:[4,8],module_nam:7,sever:[5,2],http_port:4,develop:[5,0,2,1],inventori:[0,6,3,4,1],author:1,perform:2,impact:2,make:[0,2,3,4,8],format:[0,1,2,3,4,5,6,8],cross:2,same:[5,6,8],member:5,handl:2,complex:[1,2,4],document:[7,0,2,4,8],ansibl:[0,1,2,3,4,5,6,7,8,9],difficult:2,http:3,hostnam:[7,4],denot:6,nest:3,painless:1,rail:2,someon:[],remot:[0,3,4,8],fruit:5,user:[2,4],php:8,distutil:[0,1],typic:[2,8],tune:2,recent:2,lower:2,appropri:2,off:[1,2],scenario:3,mention:4,setenforc:4,compos:4,seth:2,spent:2,non:1,without:2,command:[0,1,2,3,4,6,7,8,9],thi:[0,1,2,3,4,5,6,8],choos:3,programm:[7,2],spend:2,latest:8,next:4,identifi:2,entri:[],just:[0,1,2,3,4,8],less:[0,2,1],when:[2,3,4,8],rest:9,detail:[1,7,8],kill:8,human:[],heavili:2,ntp_server:8,simultan:8,languag:[0,1,2,3,5,6],web:[7,2,8,9],versu:1,easi:[1,2,3],mix:6,except:4,littl:[1,2],add:[0,2,8],other:[0,1,2,3,4,8],simplejson:0,notori:2,els:1,unlik:[2,4],hat:[1,2],app:2,kick:2,take:[2,3],real:0,applic:[7,2,4],around:2,ohai:[1,2,3,4,8],dest:[3,4,8],term:[],dark:7,game:1,know:[5,2,3,4],background:[1,8],world:[0,2],bit:[2,3],password:0,licens:[],daemon:[1,2],motorola:1,like:[2,3,4,5,6,8],success:3,distil:2,corpor:[],signal:[2,4],arbitrari:2,manual:2,integ:3,noth:4,edit:0,api:[7,1,2,3],necessari:[3,8],either:[2,3],lose:8,popular:1,output:[2,4],manag:[0,1,2,3,4,5,6,8],stdin:[],shed:2,didn:2,often:2,twitter:[],suppli:3,some:[0,2,3,1],back:[2,4],dead:1,born:2,heritag:2,server:[1,2,3,4,8],transport:[1,2],tmp:[4,8],googl:1,render:3,lead:2,assum:4,avoid:[0,2,3],though:[1,2,3],definit:4,thank:2,per:7,tracker:1,larg:2,cloud:2,foo:[6,8],complic:[1,2],webserv:[6,4,8],refer:8,machin:[0,2,3,4,8],core:[1,2],encourag:2,yamllint:5,run:[0,2,3,4,7,8],power:[7,1,2],usag:[3,8],asciidoc:0,web2:7,step:[2,3,4],web1:7,promot:2,repositori:0,async:2,meantim:2,major:[],appli:2,task:[1,2,4,8],soon:2,simpler:[2,8],comparison:[1,2],sbin:[3,4,8],central:2,prove:[],othervar:4,acm:8,page:[5,0,2,9,1],kept:[2,4],srv:[4,8],messag:[7,2],done:[2,4],industri:1,own:[1,2,3,4],effici:2,bounc:3,within:[2,3],contriv:4,sneaker:2,automat:3,due:2,down:7,bsd:2,multinod:2,contributor:[],chang:[3,4,8],cefengin:[],bserver:0,your:[0,1,2,3,4,5,6,8],merg:2,fast:1,fabric:[1,2],wai:[5,0,2,4,8],aren:2,transfer:[1,8],execut:[7,1,2,3,4],support:[1,2,3,8],question:[1,2],submit:2,custom:2,avail:[0,2,3,4,7,8,9],start:[0,1,2,3,4,5,8],trigger:[2,3],wordpress:4,includ:[1,3,4],lot:[1,4,8],replac:4,"var":[1,4],laserllama:1,far:1,fork:[7,2],head:[3,8],form:[5,4],enough:2,lint:5,yeah:4,github:[0,1],taken:[2,4],line:[0,1,2,3,4,5,6,7,8,9],"true":[5,3,4],freenod:1,info:[4,8],pull:2,"throw":2,made:[2,3,8],possibl:[6,4,8],inquir:[],type:[7,2],caller:3,until:0,planet:1,record:5,limit:[1,8],rerun:4,otherwis:3,problem:2,similar:3,email:1,chip:1,curv:[1,2],gather:2,tasti:5,creat:[1,2],certain:[2,4],"abstract":[],doesn:1,repres:5,strongli:2,cobbler:[1,2],file:[0,1,3,4,5,6,8],bob:4,ship:3,check:[2,3,8],probabl:2,echo:0,again:[2,4],coder:2,amqp:[],dbserver:[6,4],excel:[1,2],unnecessari:3,"default":[1,2,6],nich:[],likes_emac:5,librari:[],varieti:2,test:[0,2,3],squar:5,you:[0,1,2,3,4,5,6,8],architectur:2,node:[0,2,3,8,1],contend:2,notif:2,intend:[],clean:2,sequenc:1,"class":[1,4],devop:1,scale:[1,2],intent:2,log:4,deferenc:4,gap:2,"60k":[1,2],stai:2,sphinx:0,amp:0,soap:[],directori:[3,4],reliabl:2,itself:7,emerg:1,fact:[],potenti:4,time:[0,1,2,3,4,6,8],push:[2,4],hello:0},objtypes:{},titles:["Downloads &amp; Getting Started","Introducing Ansible","Frequently Asked Questions","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","faq","modules","playbooks","YAMLScripts","patterns","api","examples","man"]})
\ No newline at end of file
diff --git a/rst/examples.rst b/rst/examples.rst
index 3e1d4c2e00..ad5150282b 100644
--- a/rst/examples.rst
+++ b/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"
diff --git a/rst/playbooks.rst b/rst/playbooks.rst
index 218ef2538e..d54f318720 100644
--- a/rst/playbooks.rst
+++ b/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: