Show how to save conditional predicates in vars sections, which makes only_if cleaner.

2012-03-21 20:35:06 -04:00 · 2012-03-21 20:35:06 -04:00 · ee2622ee7c
commit ee2622ee7c
parent 7136ef756d
17 changed files with 30 additions and 24 deletions
--- a/YAMLSyntax.html
+++ b/YAMLSyntax.html
@ -245,7 +245,7 @@ languages:
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/api.html
+++ b/api.html
@ -330,7 +330,7 @@ a conf.d file appropriately or something similar.  Who knows.</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/examples.html
+++ b/examples.html
@ -318,7 +318,7 @@ a simplified syntax for this.</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/faq.html
+++ b/faq.html
@ -336,7 +336,7 @@ tasks &#8211; whether for a QA sytem, build system, or anything you can think of
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/genindex.html
+++ b/genindex.html
@ -160,7 +160,7 @@ s.parentNode.insertBefore(ga, s);
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/gettingstarted.html
+++ b/gettingstarted.html
@ -299,7 +299,7 @@ explore, but you already have a fully working infrastructure!</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/index.html
+++ b/index.html
@ -368,7 +368,7 @@ Puppet Labs, and rPath.  Reach Michael by email <a class="reference external" hr
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/man.html
+++ b/man.html
@ -194,7 +194,7 @@ examples of these tools in use.</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/man/ansible-playbook.1.html
+++ b/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="id499124"></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="id420106"></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>
--- a/man/ansible.1.html
+++ b/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="id536364"></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="id369179"></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>
--- a/moduledev.html
+++ b/moduledev.html
@ -394,7 +394,7 @@ Stop by the mailing list to inquire about requirements.</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/modules.html
+++ b/modules.html
@ -415,7 +415,7 @@ various configuration attributes.  Values include &#8216;installed&#8217;, &#821
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/patterns.html
+++ b/patterns.html
@ -240,7 +240,7 @@ wildcards:</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/playbooks.html
+++ b/playbooks.html
@ -386,16 +386,19 @@ and allows usage of variables from anywhere in ansible, either denoted with <cit
 <cite>{{ braces_syntax }}</cite> and then evaluates them with a Python expression.   Don&#8217;t panic &#8211; it&#8217;s actually
 pretty simple.:</p>
 <div class="highlight-python"><pre>vars:
-  - favcolor: 'red'
+  is_favcolor_blue: "'$favcolor' == 'blue'"
+  is_centos: "'$facter_operatingsystem' == 'CentOS'"
 tasks:
  - name: "shutdown if my favorite color is blue"
    action: command /sbin/shutdown -t now
-    only_if: "'$favcolor' == 'blue'"</pre>
+    only_if: '$is_favcolor_blue'</pre>
 </div>
-<p>Variables from tools like <cite>facter</cite> and <cite>ohai</cite> can also be used here, if installed.   As a reminder,
+<p>Variables from tools like <cite>facter</cite> and <cite>ohai</cite> can be used here, if installed.   As a reminder,
 these variables are prefixed, so it&#8217;s <cite>$facter_operatingsystem</cite>, not <cite>$operatingsystem</cite>.  The only_if
 expression is actually a tiny small bit of Python, so be sure to quote variables and make something
-that evaluates to <cite>True</cite> or <cite>False</cite>.</p>
+that evaluates to <cite>True</cite> or <cite>False</cite>.  It is a good idea to use &#8216;vars_files&#8217; instead of &#8216;vars&#8217; to define
+all of your conditional expressions in a way that makes them very easy to reuse between plays
+and playbooks.</p>
 <div class="admonition note">
 <p class="first admonition-title">Note</p>
 <p class="last">Handlers don&#8217;t support only_if because they don&#8217;t need to.  If a handler is not notified,
@ -618,7 +621,7 @@ Let&#8217;s run a playbook using a parallelism level of 10:</p>
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/rst/playbooks.rst
+++ b/rst/playbooks.rst
@ -262,16 +262,19 @@ and allows usage of variables from anywhere in ansible, either denoted with `$do
 pretty simple.::

    vars:
-      - favcolor: 'red'
+      is_favcolor_blue: "'$favcolor' == 'blue'"
+      is_centos: "'$facter_operatingsystem' == 'CentOS'"
    tasks:
      - name: "shutdown if my favorite color is blue"
        action: command /sbin/shutdown -t now
-        only_if: "'$favcolor' == 'blue'"
+        only_if: '$is_favcolor_blue'
      
-Variables from tools like `facter` and `ohai` can also be used here, if installed.   As a reminder,
+Variables from tools like `facter` and `ohai` can be used here, if installed.   As a reminder,
 these variables are prefixed, so it's `$facter_operatingsystem`, not `$operatingsystem`.  The only_if
 expression is actually a tiny small bit of Python, so be sure to quote variables and make something
-that evaluates to `True` or `False`.
+that evaluates to `True` or `False`.  It is a good idea to use 'vars_files' instead of 'vars' to define
+all of your conditional expressions in a way that makes them very easy to reuse between plays
+and playbooks.

 .. note::
     Handlers don't support only_if because they don't need to.  If a handler is not notified,
--- a/search.html
+++ b/search.html
@ -177,7 +177,7 @@ s.parentNode.insertBefore(ga, s);
    <p class="pull-right"><a href="#">Back to top</a></p>
    <p>
        &copy; Copyright 2012 Michael DeHaan.<br/>
-      Last updated on Mar 20, 2012.<br/>
+      Last updated on Mar 21, 2012.<br/>
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
    </p>
  </div>
--- a/searchindex.js
+++ b/searchindex.js