ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity

Move see also blocks to bottom of each page to include reading docs, remove 'fork me' to avoid text overlap,

Browse source 
simply menu nav so folks find the chapter link.
This commit is contained in:
Michael DeHaan 2012-03-31 09:29:31 -04:00
parent 39d02eeff4
commit 3a1bbac3a7
27 changed files with 160 additions and 567 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
YAMLSyntax.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,27 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">YAML Syntax</a><ul>
<li><a class="reference internal" href="#yaml-basics">YAML Basics</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="modules.html"
title="previous chapter">&laquo; Ansible Modules</a></li>
<li><a href="playbooks.html"
title="next chapter">Playbooks &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -162,11 +141,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="yaml-syntax"> <div class="section" id="yaml-syntax">
@ -176,15 +150,8 @@ playbooks (our configuration management language) are expressed.</p>
<p>We use YAML because it is easier to read and write for humans than other common <p>We use YAML because it is easier to read and write for humans than other common
data formats like XML or JSON. Further, there are libraries available for reading data formats like XML or JSON. Further, there are libraries available for reading
and writing YAML in most programming languages.</p> and writing YAML in most programming languages.</p>
<p>You may also wish to read playbook examples at the same time to see how this <p>You may also wish to read <em class="xref std std-ref">playbooks</em> at the same time to see how this
is used in practice.</p> is used in practice.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>See YAML examples in practice in playbooks</dd>
</dl>
</div>
<div class="section" id="yaml-basics"> <div class="section" id="yaml-basics">
<h2>YAML Basics<a class="headerlink" href="#yaml-basics" title="Permalink to this headline"></a></h2> <h2>YAML Basics<a class="headerlink" href="#yaml-basics" title="Permalink to this headline"></a></h2>
<p>For <cite>ansible</cite>, nearly every YAML file starts with a list. <p>For <cite>ansible</cite>, nearly every YAML file starts with a list.
@ -249,6 +216,8 @@ languages:
<dd>Learn what playbooks can do and how to write/run them.</dd> <dd>Learn what playbooks can do and how to write/run them.</dd>
<dt><a class="reference external" href="http://yamllint.com/">YAMLLint</a></dt> <dt><a class="reference external" href="http://yamllint.com/">YAMLLint</a></dt>
<dd>YAML Lint (online) helps you debug YAML syntax if you are having problems</dd> <dd>YAML Lint (online) helps you debug YAML syntax if you are having problems</dd>
<dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/examples/playbooks">Github examples directory</a></dt>
<dd>Complete playbook files from the github project source</dd>
</dl> </dl>
</div> </div>
</div> </div>
@ -261,7 +230,7 @@ languages:
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

2
_themes/bootstrap/globaltoc.html
View file

@ -1,5 +1,5 @@
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="{{ pathto(master_doc) }}" <a href="{{ pathto(master_doc) }}"
class="dropdown-toggle">{{ _('Site') }}</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc">{{ toctree(maxdepth=1) }}</span> <span class="globaltoc">{{ toctree(maxdepth=1) }}</span>
</li> </li>

12
_themes/bootstrap/layout.html
View file

@ -11,13 +11,6 @@
<ul class="nav"> <ul class="nav">
{% block sidebartoc %} {% block sidebartoc %}
{% include "globaltoc.html" %} {% include "globaltoc.html" %}
{% include "localtoc.html" %}
{% endblock %}
{% block sidebarrel %}
{% include "relations.html" %}
{% endblock %}
{% block sidebarsourcelink %}
{% include "sourcelink.html" %}
{% endblock %} {% endblock %}
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -113,11 +106,6 @@ s.parentNode.insertBefore(ga, s);
{%- block content %} {%- block content %}
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
{% block body %} {% endblock %} {% block body %} {% endblock %}
</div> </div>

41
api.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,31 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">API &amp; Integrations</a><ul>
<li><a class="reference internal" href="#python-api">Python API</a><ul>
<li><a class="reference internal" href="#detailed-api-example">Detailed API Example</a></li>
</ul>
</li>
<li><a class="reference internal" href="#external-inventory">External Inventory</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="playbooks.html"
title="previous chapter">&laquo; Playbooks</a></li>
<li><a href="moduledev.html"
title="next chapter">Module Development Guide &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -166,11 +141,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="api-integrations"> <div class="section" id="api-integrations">
@ -314,6 +284,13 @@ override any that have the same name.</p>
<p>So in other words, you can use those variables in arguments/actions as well. You might use this to name <p>So in other words, you can use those variables in arguments/actions as well. You might use this to name
a conf.d file appropriately or something similar. Who knows.</p> a conf.d file appropriately or something similar. Who knows.</p>
<p>So that&#8217;s the Cobbler integration support &#8211; using the cobbler script as an example, it should be trivial to adapt Ansible to pull inventory, as well as variable information, from any data source. If you create anything interesting, please share with the mailing list, and we can keep it in the source code tree for others to use.</p> <p>So that&#8217;s the Cobbler integration support &#8211; using the cobbler script as an example, it should be trivial to adapt Ansible to pull inventory, as well as variable information, from any data source. If you create anything interesting, please share with the mailing list, and we can keep it in the source code tree for others to use.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>List of built-in modules</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -324,7 +301,7 @@ a conf.d file appropriately or something similar. Who knows.</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

53
examples.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,32 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<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>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="patterns.html"
title="previous chapter">&laquo; The Inventory File, Patterns, and Groups</a></li>
<li><a href="modules.html"
title="next chapter">Ansible Modules &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -167,11 +141,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="command-line-examples"> <div class="section" id="command-line-examples">
@ -179,15 +148,6 @@ alt="Fork me on GitHub"
<p>The following examples show how to use <cite>/usr/bin/ansible</cite> for running ad-hoc tasks. <p>The following examples show how to use <cite>/usr/bin/ansible</cite> for running ad-hoc tasks.
Start here. For configuration management and deployments, you&#8217;ll want to pick up on Start here. For configuration management and deployments, you&#8217;ll want to pick up on
using <cite>/usr/bin/ansible-playbook</cite> &#8211; the concepts port over directly.</p> using <cite>/usr/bin/ansible-playbook</cite> &#8211; the concepts port over directly.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>A list of available modules</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Alternative ways to use ansible</dd>
</dl>
</div>
<div class="section" id="parallelism-and-shell-commands"> <div class="section" id="parallelism-and-shell-commands">
<h2>Parallelism and Shell Commands<a class="headerlink" href="#parallelism-and-shell-commands" title="Permalink to this headline"></a></h2> <h2>Parallelism and Shell Commands<a class="headerlink" href="#parallelism-and-shell-commands" title="Permalink to this headline"></a></h2>
<p>Let&#8217;s use ansible&#8217;s command line tool to reboot all web servers in Atlanta, 10 at a time:</p> <p>Let&#8217;s use ansible&#8217;s command line tool to reboot all web servers in Atlanta, 10 at a time:</p>
@ -304,6 +264,15 @@ the remote nodes will be terminated.</p>
<p>Any module other than <a class="reference internal" href="modules.html#copy"><em>copy</em></a> or <a class="reference internal" href="modules.html#template"><em>template</em></a> can be <p>Any module other than <a class="reference internal" href="modules.html#copy"><em>copy</em></a> or <a class="reference internal" href="modules.html#template"><em>template</em></a> can be
backgrounded. Typically you&#8217;ll be backgrounding long-running backgrounded. Typically you&#8217;ll be backgrounding long-running
shell commands or software upgrades only.</p> shell commands or software upgrades only.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>A list of available modules</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Using ansible for configuration management &amp; deployment</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -314,7 +283,7 @@ shell commands or software upgrades only.</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

43
faq.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,40 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Frequently Asked Questions</a><ul>
<li><a class="reference internal" href="#what-inspired-ansible">What inspired Ansible?</a></li>
<li><a class="reference internal" href="#comparisons">Comparisons</a><ul>
<li><a class="reference internal" href="#vs-func">vs Func?</a></li>
<li><a class="reference internal" href="#vs-puppet">vs Puppet?</a></li>
<li><a class="reference internal" href="#vs-chef">vs Chef?</a></li>
<li><a class="reference internal" href="#vs-capistrano-fabric">vs Capistrano/Fabric?</a></li>
</ul>
</li>
<li><a class="reference internal" href="#other-questions">Other Questions</a><ul>
<li><a class="reference internal" href="#how-does-ansible-scale">How does Ansible scale?</a></li>
<li><a class="reference internal" href="#are-transports-other-than-ssh-supported">Are transports other than SSH supported?</a></li>
<li><a class="reference internal" href="#what-are-some-ideal-uses-for-ansible">What are some ideal uses for Ansible?</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="moduledev.html"
title="previous chapter">&laquo; Module Development Guide</a></li>
<li><a href="man.html"
title="next chapter">Man Pages &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -175,11 +141,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="frequently-asked-questions"> <div class="section" id="frequently-asked-questions">
@ -347,7 +308,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 class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

23
genindex.html
View file

@ -107,7 +107,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul> <span class="globaltoc"><ul>
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -122,20 +122,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"></span>
</li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -153,11 +139,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
@ -174,7 +155,7 @@ alt="Fork me on GitHub"
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

46
gettingstarted.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="">Downloads &amp; Getting Started</a></li> <li class="toctree-l1 current"><a class="current reference internal" href="">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,34 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Downloads &amp; Getting Started</a><ul>
<li><a class="reference internal" href="#requirements">Requirements</a></li>
<li><a class="reference internal" href="#developer-requirements">Developer Requirements</a></li>
<li><a class="reference internal" href="#getting-ansible">Getting Ansible</a><ul>
<li><a class="reference internal" href="#python-distutils">Python Distutils</a></li>
<li><a class="reference internal" href="#via-rpm">Via RPM</a></li>
</ul>
</li>
<li><a class="reference internal" href="#your-first-commands">Your first commands</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="index.html"
title="previous chapter">&laquo; Introducing Ansible</a></li>
<li><a href="patterns.html"
title="next chapter">The Inventory File, Patterns, and Groups &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -169,25 +141,11 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="downloads-getting-started"> <div class="section" id="downloads-getting-started">
<h1>Downloads &amp; Getting Started<a class="headerlink" href="#downloads-getting-started" title="Permalink to this headline"></a></h1> <h1>Downloads &amp; Getting Started<a class="headerlink" href="#downloads-getting-started" title="Permalink to this headline"></a></h1>
<p>How to download ansible and get started using it</p> <p>How to download ansible and get started using it</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of basic commands</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Learning ansible&#8217;s configuration management language</dd>
</dl>
</div>
<div class="section" id="requirements"> <div class="section" id="requirements">
<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline"></a></h2> <h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline"></a></h2>
<p>Requirements for Ansible are extremely minimal.</p> <p>Requirements for Ansible are extremely minimal.</p>
@ -289,7 +247,7 @@ you already have a working infrastructure!</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

34
index.html
View file

@ -108,7 +108,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="#" <a href="#"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul> <span class="globaltoc"><ul>
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -123,31 +123,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Introducing Ansible</a><ul>
<li><a class="reference internal" href="#architecture">Architecture</a></li>
<li><a class="reference internal" href="#design-goals">Design Goals</a></li>
<li><a class="reference internal" href="#resources">Resources</a></li>
</ul>
</li>
<li><a class="reference internal" href="#contents">Contents</a><ul>
<li><a class="reference internal" href="#about-the-author">About the Author</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="gettingstarted.html"
title="next chapter">Downloads &amp; Getting Started &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -165,11 +140,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<a class="reference external image-reference" href="http://photos.michaeldehaan.net/infrared/h3d850bdf#h3d850bdf"><img alt="&quot;&quot;" src="http://ansible.github.com/mpd_rings.jpg" style="width: 300px; height: 225px;" /></a> <a class="reference external image-reference" href="http://photos.michaeldehaan.net/infrared/h3d850bdf#h3d850bdf"><img alt="&quot;&quot;" src="http://ansible.github.com/mpd_rings.jpg" style="width: 300px; height: 225px;" /></a>
@ -363,7 +333,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 class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

40
man.html
View file

@ -108,7 +108,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -123,26 +123,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Man Pages</a><ul>
<li><a class="reference internal" href="#ansible-1">ansible(1)</a></li>
<li><a class="reference internal" href="#ansible-playbook-1">ansible-playbook(1)</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="faq.html"
title="previous chapter">&laquo; Frequently Asked Questions</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -160,11 +140,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="man-pages"> <div class="section" id="man-pages">
@ -182,6 +157,17 @@ examples of these tools in use.</p>
<ul class="simple"> <ul class="simple">
<li><a class="reference external" href="man/ansible-playbook.1.html">View ansible-playbook.1</a></li> <li><a class="reference external" href="man/ansible-playbook.1.html">View ansible-playbook.1</a></li>
</ul> </ul>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of basic commands</dd>
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>List of built-in modules</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Learning ansible&#8217;s configuration management language</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -192,7 +178,7 @@ examples of these tools in use.</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

2
man/ansible-playbook.1.html
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?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"> <!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="id393550"></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="id422529"></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"> 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 class="strong"><strong>filename.yml</strong></span>
</span></dt><dd> </span></dt><dd>

2
man/ansible.1.html
View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?> <?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"> <!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="id424133"></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="id560223"></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"> 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 class="strong"><strong>host-pattern</strong></span>
</span></dt><dd> </span></dt><dd>

55
moduledev.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,34 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Module Development Guide</a><ul>
<li><a class="reference internal" href="#tutorial">Tutorial</a></li>
<li><a class="reference internal" href="#testing-modules">Testing Modules</a></li>
<li><a class="reference internal" href="#reading-input">Reading Input</a></li>
<li><a class="reference internal" href="#common-pitfalls">Common Pitfalls</a></li>
<li><a class="reference internal" href="#conventions">Conventions</a></li>
<li><a class="reference internal" href="#shorthand-vs-json">Shorthand Vs JSON</a></li>
<li><a class="reference internal" href="#sharing-your-module">Sharing Your Module</a></li>
<li><a class="reference internal" href="#getting-your-module-into-core">Getting Your Module Into Core</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="api.html"
title="previous chapter">&laquo; API &amp; Integrations</a></li>
<li><a href="faq.html"
title="next chapter">Frequently Asked Questions &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -169,24 +141,10 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="module-development-guide"> <div class="section" id="module-development-guide">
<h1>Module Development Guide<a class="headerlink" href="#module-development-guide" title="Permalink to this headline"></a></h1> <h1>Module Development Guide<a class="headerlink" href="#module-development-guide" title="Permalink to this headline"></a></h1>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>Learn about available modules</dd>
<dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/library">Github modules directory</a></dt>
<dd>Browse source of core modules</dd>
</dl>
</div>
<p>Ansible modules are reusable units of magic that can be used by the Ansible API, <p>Ansible modules are reusable units of magic that can be used by the Ansible API,
or by the <cite>ansible</cite> or <cite>ansible-playbook</cite> programs.</p> or by the <cite>ansible</cite> or <cite>ansible-playbook</cite> programs.</p>
<p>Modules can be written in any language and are found in the path specified <p>Modules can be written in any language and are found in the path specified
@ -395,6 +353,15 @@ up as many of these as possible in as many languages as possible.</p>
can be included in the core, but core modules (just due to the programming can be included in the core, but core modules (just due to the programming
preferences of the developers) will need to be implemented in Python. preferences of the developers) will need to be implemented in Python.
Stop by the mailing list to inquire about requirements.</p> Stop by the mailing list to inquire about requirements.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>Learn about available modules</dd>
<dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/library">Github modules directory</a></dt>
<dd>Browse source of core modules</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -405,7 +372,7 @@ Stop by the mailing list to inquire about requirements.</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

64
modules.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,39 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Ansible Modules</a><ul>
<li><a class="reference internal" href="#command">command</a></li>
<li><a class="reference internal" href="#copy">copy</a></li>
<li><a class="reference internal" href="#facter">facter</a></li>
<li><a class="reference internal" href="#file">file</a></li>
<li><a class="reference internal" href="#git">git</a></li>
<li><a class="reference internal" href="#ohai">ohai</a></li>
<li><a class="reference internal" href="#ping">ping</a></li>
<li><a class="reference internal" href="#service">service</a></li>
<li><a class="reference internal" href="#setup">setup</a></li>
<li><a class="reference internal" href="#shell">shell</a></li>
<li><a class="reference internal" href="#template">template</a></li>
<li><a class="reference internal" href="#yum">yum</a></li>
<li><a class="reference internal" href="#writing-your-own-modules">Writing your own modules</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="examples.html"
title="previous chapter">&laquo; Command Line Examples</a></li>
<li><a href="YAMLSyntax.html"
title="next chapter">YAML Syntax &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -174,28 +141,12 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="ansible-modules"> <div class="section" id="ansible-modules">
<h1>Ansible Modules<a class="headerlink" href="#ansible-modules" title="Permalink to this headline"></a></h1> <h1>Ansible Modules<a class="headerlink" href="#ansible-modules" title="Permalink to this headline"></a></h1>
<p>Ansible ships with a number of modules that can be executed directly <p>Ansible ships with a number of modules that can be executed directly
on remote hosts or through ansible playbooks.</p> on remote hosts or through ansible playbooks.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of using modules in /usr/bin/ansible</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Examples of using modules with /usr/bin/ansible-playbook</dd>
<dt><a class="reference internal" href="api.html"><em>API &amp; Integrations</em></a></dt>
<dd>Examples of using modules with the Python API</dd>
</dl>
</div>
<p>Nearly all modules take <tt class="docutils literal"><span class="pre">key=value</span></tt> parameters, space delimited. Some modules take <p>Nearly all modules take <tt class="docutils literal"><span class="pre">key=value</span></tt> parameters, space delimited. Some modules take
no parameters, and the command/shell modules simply take the string no parameters, and the command/shell modules simply take the string
of the command you want to run.</p> of the command you want to run.</p>
@ -425,6 +376,17 @@ the module:</p>
module path to the command line tool or API. It is easy to test module path to the command line tool or API. It is easy to test
modules by running them directly on the command line, passing them modules by running them directly on the command line, passing them
arguments just like they would be passed with ansible.</p> arguments just like they would be passed with ansible.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of using modules in /usr/bin/ansible</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Examples of using modules with /usr/bin/ansible-playbook</dd>
<dt><a class="reference internal" href="api.html"><em>API &amp; Integrations</em></a></dt>
<dd>Examples of using modules with the Python API</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -435,7 +397,7 @@ arguments just like they would be passed with ansible.</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

51
patterns.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1 current"><a class="current reference internal" href="">The Inventory File, Patterns, and Groups</a></li>
@ -124,28 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">The Inventory File, Patterns, and Groups</a><ul>
<li><a class="reference internal" href="#inventory-file-format">Inventory File Format</a></li>
<li><a class="reference internal" href="#selecting-targets">Selecting Targets</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="gettingstarted.html"
title="previous chapter">&laquo; Downloads &amp; Getting Started</a></li>
<li><a href="examples.html"
title="next chapter">Command Line Examples &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -163,25 +141,11 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="the-inventory-file-patterns-and-groups"> <div class="section" id="the-inventory-file-patterns-and-groups">
<span id="patterns"></span><h1>The Inventory File, Patterns, and Groups<a class="headerlink" href="#the-inventory-file-patterns-and-groups" title="Permalink to this headline"></a></h1> <span id="patterns"></span><h1>The Inventory File, Patterns, and Groups<a class="headerlink" href="#the-inventory-file-patterns-and-groups" title="Permalink to this headline"></a></h1>
<p>How to select hosts you wish to manage</p> <p>How to define and select hosts you wish to manage</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of basic commands</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Learning ansible&#8217;s configuration management language</dd>
</dl>
</div>
<div class="section" id="inventory-file-format"> <div class="section" id="inventory-file-format">
<span id="inventoryformat"></span><h2>Inventory File Format<a class="headerlink" href="#inventory-file-format" title="Permalink to this headline"></a></h2> <span id="inventoryformat"></span><h2>Inventory File Format<a class="headerlink" href="#inventory-file-format" title="Permalink to this headline"></a></h2>
<p>Ansible works against multiple systems in your infrastructure at the <p>Ansible works against multiple systems in your infrastructure at the
@ -233,6 +197,15 @@ wildcards:</p>
<p class="last">It is not possible to target a host not in the inventory file. This is a safety feature.</p> <p class="last">It is not possible to target a host not in the inventory file. This is a safety feature.</p>
</div> </div>
<p>Easy enough. Now see <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a> and then <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a> for how to do things to selected hosts.</p> <p>Easy enough. Now see <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a> and then <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a> for how to do things to selected hosts.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="examples.html"><em>Command Line Examples</em></a></dt>
<dd>Examples of basic commands</dd>
<dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
<dd>Learning ansible&#8217;s configuration management language</dd>
</dl>
</div>
</div> </div>
</div> </div>
@ -243,7 +216,7 @@ wildcards:</p>
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

77
playbooks.html
View file

@ -109,7 +109,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul class="current"> <span class="globaltoc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -124,42 +124,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"><ul>
<li><a class="reference internal" href="#">Playbooks</a><ul>
<li><a class="reference internal" href="#playbook-example">Playbook Example</a></li>
<li><a class="reference internal" href="#hosts-line">Hosts line</a></li>
<li><a class="reference internal" href="#user-line">User line</a></li>
<li><a class="reference internal" href="#vars-section">Vars section</a></li>
<li><a class="reference internal" href="#tasks-list">Tasks list</a></li>
<li><a class="reference internal" href="#task-name-and-action">Task name and action</a></li>
<li><a class="reference internal" href="#notify-statements">Notify statements</a></li>
<li><a class="reference internal" href="#handlers">Handlers</a></li>
<li><a class="reference internal" href="#power-tricks">Power Tricks</a><ul>
<li><a class="reference internal" href="#external-variables-and-sensitive-data">External Variables And Sensitive Data</a></li>
<li><a class="reference internal" href="#include-files-and-reuse">Include Files And Reuse</a></li>
<li><a class="reference internal" href="#using-includes-to-assign-classes-of-systems">Using Includes To Assign Classes of Systems</a></li>
<li><a class="reference internal" href="#asynchronous-actions-and-polling">Asynchronous Actions and Polling</a></li>
</ul>
</li>
<li><a class="reference internal" href="#executing-a-playbook">Executing A Playbook</a></li>
</ul>
</li>
</ul>
</span>
</li>
<li><a href="YAMLSyntax.html"
title="previous chapter">&laquo; YAML Syntax</a></li>
<li><a href="api.html"
title="next chapter">API &amp; Integrations &raquo;</a></li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -177,30 +141,10 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<div class="section" id="playbooks"> <div class="section" id="playbooks">
<h1>Playbooks<a class="headerlink" href="#playbooks" title="Permalink to this headline"></a></h1> <h1>Playbooks<a class="headerlink" href="#playbooks" title="Permalink to this headline"></a></h1>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<dl class="last docutils">
<dt><a class="reference internal" href="YAMLSyntax.html"><em>YAML Syntax</em></a></dt>
<dd>Learn about YAML syntax</dd>
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>Learn about available modules</dd>
<dt><a class="reference internal" href="moduledev.html"><em>Module Development Guide</em></a></dt>
<dd>Learn how to extend Ansible by writing your own modules</dd>
<dt><a class="reference internal" href="patterns.html"><em>The Inventory File, Patterns, and Groups</em></a></dt>
<dd>Learn about how to select hosts</dd>
<dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/examples/playbooks">Github examples directory</a></dt>
<dd>Complete playbook files from the github project source</dd>
</dl>
</div>
<p>Playbooks are a completely different way to use ansible and are <p>Playbooks are a completely different way to use ansible and are
particularly awesome.</p> particularly awesome.</p>
<p>They are the basis for a really simple configuration management and <p>They are the basis for a really simple configuration management and
@ -529,9 +473,20 @@ tasks even faster. This also increases the efficiency of polling.</p>
Let&#8217;s run a playbook using a parallelism level of 10:</p> Let&#8217;s run a playbook using a parallelism level of 10:</p>
<div class="highlight-python"><pre>ansible-playbook playbook.yml -f 10</pre> <div class="highlight-python"><pre>ansible-playbook playbook.yml -f 10</pre>
</div> </div>
<div class="admonition note"> <div class="admonition-see-also admonition seealso">
<p class="first admonition-title">Note</p> <p class="first admonition-title">See also</p>
<p class="last">Don&#8217;t forget to check out the <a class="reference external" href="https://github.com/ansible/ansible/tree/master/examples/playbooks">Github examples directory</a> for examples of playbooks in action, so you can see how all of these features can be put together.</p> <dl class="last docutils">
<dt><a class="reference internal" href="YAMLSyntax.html"><em>YAML Syntax</em></a></dt>
<dd>Learn about YAML syntax</dd>
<dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
<dd>Learn about available modules</dd>
<dt><a class="reference internal" href="moduledev.html"><em>Module Development Guide</em></a></dt>
<dd>Learn how to extend Ansible by writing your own modules</dd>
<dt><a class="reference internal" href="patterns.html"><em>The Inventory File, Patterns, and Groups</em></a></dt>
<dd>Learn about how to select hosts</dd>
<dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/examples/playbooks">Github examples directory</a></dt>
<dd>Complete playbook files from the github project source</dd>
</dl>
</div> </div>
</div> </div>
</div> </div>
@ -543,7 +498,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 class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

10
rst/YAMLSyntax.rst
View file

@ -8,14 +8,9 @@ We use YAML because it is easier to read and write for humans than other common
data formats like XML or JSON. Further, there are libraries available for reading data formats like XML or JSON. Further, there are libraries available for reading
and writing YAML in most programming languages. and writing YAML in most programming languages.
You may also wish to read playbook examples at the same time to see how this You may also wish to read :ref:`playbooks` at the same time to see how this
is used in practice. is used in practice.
.. seealso::
:doc:`playbooks`
See YAML examples in practice in playbooks
YAML Basics YAML Basics
----------- -----------
@ -91,4 +86,7 @@ That's all you really need to know about YAML to get started writing
Learn what playbooks can do and how to write/run them. Learn what playbooks can do and how to write/run them.
`YAMLLint <http://yamllint.com/>`_ `YAMLLint <http://yamllint.com/>`_
YAML Lint (online) helps you debug YAML syntax if you are having problems YAML Lint (online) helps you debug YAML syntax if you are having problems
`Github examples directory <https://github.com/ansible/ansible/tree/master/examples/playbooks>`_
Complete playbook files from the github project source

4
rst/api.rst
View file

@ -170,4 +170,8 @@ a conf.d file appropriately or something similar. Who knows.
So that's the Cobbler integration support -- using the cobbler script as an example, it should be trivial to adapt Ansible to pull inventory, as well as variable information, from any data source. If you create anything interesting, please share with the mailing list, and we can keep it in the source code tree for others to use. So that's the Cobbler integration support -- using the cobbler script as an example, it should be trivial to adapt Ansible to pull inventory, as well as variable information, from any data source. If you create anything interesting, please share with the mailing list, and we can keep it in the source code tree for others to use.
.. seealso::
:doc:`modules`
List of built-in modules

14
rst/examples.rst
View file

@ -5,13 +5,6 @@ The following examples show how to use `/usr/bin/ansible` for running ad-hoc tas
Start here. For configuration management and deployments, you'll want to pick up on Start here. For configuration management and deployments, you'll want to pick up on
using `/usr/bin/ansible-playbook` -- the concepts port over directly. using `/usr/bin/ansible-playbook` -- the concepts port over directly.
.. seealso::
:doc:`modules`
A list of available modules
:doc:`playbooks`
Alternative ways to use ansible
Parallelism and Shell Commands Parallelism and Shell Commands
`````````````````````````````` ``````````````````````````````
@ -157,6 +150,11 @@ Any module other than :ref:`copy` or :ref:`template` can be
backgrounded. Typically you'll be backgrounding long-running backgrounded. Typically you'll be backgrounding long-running
shell commands or software upgrades only. shell commands or software upgrades only.
.. seealso::
:doc:`modules`
A list of available modules
:doc:`playbooks`
Using ansible for configuration management & deployment

7
rst/gettingstarted.rst
View file

@ -3,13 +3,6 @@ Downloads & Getting Started
How to download ansible and get started using it How to download ansible and get started using it
.. seealso::
:doc:`examples`
Examples of basic commands
:doc:`playbooks`
Learning ansible's configuration management language
Requirements Requirements
```````````` ````````````

9
rst/man.rst
View file

@ -16,3 +16,12 @@ ansible-playbook(1)
* `View ansible-playbook.1 <man/ansible-playbook.1.html>`_ * `View ansible-playbook.1 <man/ansible-playbook.1.html>`_
.. seealso::
:doc:`examples`
Examples of basic commands
:doc:`modules`
List of built-in modules
:doc:`playbooks`
Learning ansible's configuration management language

14
rst/moduledev.rst
View file

@ -1,14 +1,6 @@
Module Development Guide Module Development Guide
======================== ========================
.. seealso::
:doc:`modules`
Learn about available modules
`Github modules directory <https://github.com/ansible/ansible/tree/master/library>`_
Browse source of core modules
Ansible modules are reusable units of magic that can be used by the Ansible API, Ansible modules are reusable units of magic that can be used by the Ansible API,
or by the `ansible` or `ansible-playbook` programs. or by the `ansible` or `ansible-playbook` programs.
@ -250,4 +242,10 @@ can be included in the core, but core modules (just due to the programming
preferences of the developers) will need to be implemented in Python. preferences of the developers) will need to be implemented in Python.
Stop by the mailing list to inquire about requirements. Stop by the mailing list to inquire about requirements.
.. seealso::
:doc:`modules`
Learn about available modules
`Github modules directory <https://github.com/ansible/ansible/tree/master/library>`_
Browse source of core modules

18
rst/modules.rst
View file

@ -4,15 +4,6 @@ Ansible Modules
Ansible ships with a number of modules that can be executed directly Ansible ships with a number of modules that can be executed directly
on remote hosts or through ansible playbooks. on remote hosts or through ansible playbooks.
.. seealso::
:doc:`examples`
Examples of using modules in /usr/bin/ansible
:doc:`playbooks`
Examples of using modules with /usr/bin/ansible-playbook
:doc:`api`
Examples of using modules with the Python API
Nearly all modules take ``key=value`` parameters, space delimited. Some modules take Nearly all modules take ``key=value`` parameters, space delimited. Some modules take
no parameters, and the command/shell modules simply take the string no parameters, and the command/shell modules simply take the string
of the command you want to run. of the command you want to run.
@ -301,3 +292,12 @@ When shipping modules, drop them in /usr/share/ansible, or specify the
module path to the command line tool or API. It is easy to test module path to the command line tool or API. It is easy to test
modules by running them directly on the command line, passing them modules by running them directly on the command line, passing them
arguments just like they would be passed with ansible. arguments just like they would be passed with ansible.
.. seealso::
:doc:`examples`
Examples of using modules in /usr/bin/ansible
:doc:`playbooks`
Examples of using modules with /usr/bin/ansible-playbook
:doc:`api`
Examples of using modules with the Python API

16
rst/patterns.rst
View file

@ -3,15 +3,7 @@
The Inventory File, Patterns, and Groups The Inventory File, Patterns, and Groups
======================================== ========================================
How to select hosts you wish to manage How to define and select hosts you wish to manage
.. seealso::
:doc:`examples`
Examples of basic commands
:doc:`playbooks`
Learning ansible's configuration management language
.. _inventoryformat: .. _inventoryformat:
@ -73,4 +65,10 @@ It's also ok to mix wildcard patterns and groups at the same time::
Easy enough. Now see :doc:`examples` and then :doc:`playbooks` for how to do things to selected hosts. Easy enough. Now see :doc:`examples` and then :doc:`playbooks` for how to do things to selected hosts.
.. seealso::
:doc:`examples`
Examples of basic commands
:doc:`playbooks`
Learning ansible's configuration management language

27
rst/playbooks.rst
View file

@ -1,20 +1,6 @@
Playbooks Playbooks
========= =========
.. seealso::
:doc:`YAMLSyntax`
Learn about YAML syntax
:doc:`modules`
Learn about available modules
:doc:`moduledev`
Learn how to extend Ansible by writing your own modules
:doc:`patterns`
Learn about how to select hosts
`Github examples directory <https://github.com/ansible/ansible/tree/master/examples/playbooks>`_
Complete playbook files from the github project source
Playbooks are a completely different way to use ansible and are Playbooks are a completely different way to use ansible and are
particularly awesome. particularly awesome.
@ -398,7 +384,16 @@ Let's run a playbook using a parallelism level of 10::
ansible-playbook playbook.yml -f 10 ansible-playbook playbook.yml -f 10
.. note:: .. seealso::
Don't forget to check out the `Github examples directory <https://github.com/ansible/ansible/tree/master/examples/playbooks>`_ for examples of playbooks in action, so you can see how all of these features can be put together.
:doc:`YAMLSyntax`
Learn about YAML syntax
:doc:`modules`
Learn about available modules
:doc:`moduledev`
Learn how to extend Ansible by writing your own modules
:doc:`patterns`
Learn about how to select hosts
`Github examples directory <https://github.com/ansible/ansible/tree/master/examples/playbooks>`_
Complete playbook files from the github project source

20
search.html
View file

@ -113,7 +113,7 @@ s.parentNode.insertBefore(ga, s);
<li class="dropdown" data-dropdown="dropdown"> <li class="dropdown" data-dropdown="dropdown">
<a href="index.html" <a href="index.html"
class="dropdown-toggle">Site</a> class="dropdown-toggle">Chapter</a>
<span class="globaltoc"><ul> <span class="globaltoc"><ul>
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li> <li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Downloads &amp; Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li> <li class="toctree-l1"><a class="reference internal" href="patterns.html">The Inventory File, Patterns, and Groups</a></li>
@ -128,17 +128,6 @@ s.parentNode.insertBefore(ga, s);
</ul> </ul>
</span> </span>
</li> </li>
<li class="dropdown" data-dropdown="dropdown">
<a href="#"
class="dropdown-toggle">Page</a>
<span class="localtoc"></span>
</li>
</ul> </ul>
<ul class="nav secondary-nav"> <ul class="nav secondary-nav">
@ -151,11 +140,6 @@ s.parentNode.insertBefore(ga, s);
</div> </div>
<a href="https://github.com/ansible/ansible"><img
style="position: absolute; top: 40px; right: 0; border: 0;"
src="https://a248.e.akamai.net/assets.github.com/img/71eeaab9d563c2b3c590319b398dd35683265e85/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f677261795f3664366436642e706e67"
alt="Fork me on GitHub"
alt="Fork me on GitHub"></a>
<div class="container"> <div class="container">
<h1 id="search-documentation">Search</h1> <h1 id="search-documentation">Search</h1>
@ -188,7 +172,7 @@ alt="Fork me on GitHub"
<p class="pull-right"><a href="#">Back to top</a></p> <p class="pull-right"><a href="#">Back to top</a></p>
<p> <p>
&copy; Copyright 2012 Michael DeHaan.<br/> &copy; Copyright 2012 Michael DeHaan.<br/>
Last updated on Mar 30, 2012.<br/> Last updated on Mar 31, 2012.<br/>
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/> Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.8.<br/>
</p> </p>
</div> </div>

2
searchindex.js
View file

File diff suppressed because one or more lines are too long