Clarify some things on index page

This commit is contained in:
Michael DeHaan 2012-03-18 13:03:45 -04:00
parent 00bf6f1ebf
commit cd06703fa2
6 changed files with 21 additions and 17 deletions

View file

@ -274,7 +274,7 @@ ssh-add ~/.ssh/id_rsa</pre>
now time to read some of the more real-world <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a>, and explore now time to read some of the more real-world <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a>, and explore
what you can do with different modules, as well as the Ansible what you can do with different modules, as well as the Ansible
<a class="reference internal" href="playbooks.html"><em>Playbooks</em></a> language. Ansible is not just about running commands, it <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a> language. Ansible is not just about running commands, it
also has powerful configuration and deployment features. There&#8217;s more to also has powerful configuration management and deployment features. There&#8217;s more to
explore, but you already have a fully working infrastructure!</p> explore, but you already have a fully working infrastructure!</p>
<div class="admonition-see-also admonition seealso"> <div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p> <p class="first admonition-title">See also</p>

View file

@ -164,17 +164,17 @@ s.parentNode.insertBefore(ga, s);
<a class="reference external image-reference" href="http://photos.michaeldehaan.net/ncsu/h3b63b68e#h3b63b68e"><img alt="&quot;&quot;" src="http://ansible.github.com/mpd_tubes.jpg" style="width: 225px; height: 225px;" /></a> <a class="reference external image-reference" href="http://photos.michaeldehaan.net/ncsu/h3b63b68e#h3b63b68e"><img alt="&quot;&quot;" src="http://ansible.github.com/mpd_tubes.jpg" style="width: 225px; height: 225px;" /></a>
<div class="section" id="introducing-ansible"> <div class="section" id="introducing-ansible">
<h1>Introducing Ansible<a class="headerlink" href="#introducing-ansible" title="Permalink to this headline"></a></h1> <h1>Introducing Ansible<a class="headerlink" href="#introducing-ansible" title="Permalink to this headline"></a></h1>
<p>Ansible is a radically simple deployment, configuration, and command <p>Ansible is a radically simple deployment, model-driven configuration management,
execution framework. Other similar tools have been too and command execution framework. Other tools in this space have been too
complicated for too long, require too much bootstrapping, and have too complicated for too long, require too much bootstrapping, and have too
much learning curve. Ansible is dead simple and painless to extend. much learning curve. Ansible is dead simple and painless to extend.
For comparison, Puppet and Chef have about 60k lines of code. For comparison, Puppet and Chef have about 60k lines of code.
Ansible&#8217;s core is a little over 1000 lines.</p> Ansible&#8217;s core is a little over 1000 lines.</p>
<p>Ansible isn&#8217;t just for configuration &#8211; it&#8217;s also great for Ad-Hoc <p>Ansible isn&#8217;t just for idempotent configuration &#8211; it&#8217;s also great for ad-hoc
tasks, quickly firing off commands against nodes. See <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a>. tasks, quickly firing off commands against nodes. See <a class="reference internal" href="examples.html"><em>Command Line Examples</em></a>.
Where Ansible excels though, is expressing complex multi-node Where Ansible excels though, is expressing complex multi-node
deployment processes, executing complex sequences of commands on deployment processes, executing ordered sequences on
different hosts through <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a>.</p> different sets of nodes through <a class="reference internal" href="playbooks.html"><em>Playbooks</em></a>.</p>
<p>Extending ansible does not require programming in any particular <p>Extending ansible does not require programming in any particular
language &#8211; you can write <a class="reference internal" href="modules.html"><em>Ansible Modules</em></a> as scripts or programs that return language &#8211; you can write <a class="reference internal" href="modules.html"><em>Ansible Modules</em></a> as scripts or programs that return
simple JSON. It&#8217;s also trivially easy to just execute useful shell simple JSON. It&#8217;s also trivially easy to just execute useful shell
@ -197,9 +197,11 @@ will remain short &amp; simple, and the source will be blindingly obvious.</p>
<li>Super fast &amp; parallel by default</li> <li>Super fast &amp; parallel by default</li>
<li>No server or client daemons; use existing SSHd out of the box</li> <li>No server or client daemons; use existing SSHd out of the box</li>
<li>No additional software required on client boxes</li> <li>No additional software required on client boxes</li>
<li>Can be easily run from a checkout, no installation required</li>
<li>Modules are idempotent</li>
<li>Modules can be written in ANY language</li> <li>Modules can be written in ANY language</li>
<li>Awesome API for creating very powerful distributed scripts</li> <li>Awesome API for creating very powerful distributed scripts</li>
<li>Be very usable as non-root</li> <li>Does not have to run remote steps as root</li>
<li>Create the easiest config management system to use, ever.</li> <li>Create the easiest config management system to use, ever.</li>
</ul> </ul>
</div> </div>

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="id535032"></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="id510968"></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>

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="id468234"></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="id522608"></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>

View file

@ -17,18 +17,18 @@
Introducing Ansible Introducing Ansible
=================== ===================
Ansible is a radically simple deployment, configuration, and command Ansible is a radically simple deployment, model-driven configuration management,
execution framework. Other similar tools have been too and command execution framework. Other tools in this space have been too
complicated for too long, require too much bootstrapping, and have too complicated for too long, require too much bootstrapping, and have too
much learning curve. Ansible is dead simple and painless to extend. much learning curve. Ansible is dead simple and painless to extend.
For comparison, Puppet and Chef have about 60k lines of code. For comparison, Puppet and Chef have about 60k lines of code.
Ansible's core is a little over 1000 lines. Ansible's core is a little over 1000 lines.
Ansible isn't just for configuration -- it's also great for Ad-Hoc Ansible isn't just for idempotent configuration -- it's also great for ad-hoc
tasks, quickly firing off commands against nodes. See :doc:`examples`. tasks, quickly firing off commands against nodes. See :doc:`examples`.
Where Ansible excels though, is expressing complex multi-node Where Ansible excels though, is expressing complex multi-node
deployment processes, executing complex sequences of commands on deployment processes, executing ordered sequences on
different hosts through :doc:`playbooks`. different sets of nodes through :doc:`playbooks`.
Extending ansible does not require programming in any particular Extending ansible does not require programming in any particular
language -- you can write :doc:`modules` as scripts or programs that return language -- you can write :doc:`modules` as scripts or programs that return
@ -60,9 +60,11 @@ Design Goals
* Super fast & parallel by default * Super fast & parallel by default
* No server or client daemons; use existing SSHd out of the box * No server or client daemons; use existing SSHd out of the box
* No additional software required on client boxes * No additional software required on client boxes
* Can be easily run from a checkout, no installation required
* Modules are idempotent
* Modules can be written in ANY language * Modules can be written in ANY language
* Awesome API for creating very powerful distributed scripts * Awesome API for creating very powerful distributed scripts
* Be very usable as non-root * Does not have to run remote steps as root
* Create the easiest config management system to use, ever. * Create the easiest config management system to use, ever.
Resources Resources

File diff suppressed because one or more lines are too long