mirror of https://github.com/ansible/ansible.git
Add manpage for ansible-playbook, since it is a command. More detailed docs will remain on the web site.
Michael DeHaan
12 years ago
parent
1699013fbd
commit
209760f8f6
@ -1,203 +0,0 @@
|
||||
Comparisons
|
||||
===========
|
||||
|
||||
Confused about how Ansible fits in? Here's a comparison with some common tools.
|
||||
|
||||
Accuracy is important, so corrections are VERY welcome if we've got something wrong.
|
||||
For space reasons, we can't list everybody's favorite management tool.
|
||||
|
||||
Ansible mainly tries to be different in it's goals of minimalism, while also cutting across
|
||||
the categories of configuration management, deployment, and ad-hoc task firing.
|
||||
|
||||
It strives to be a super-easy to use app, requiring no daemons or databases, and having
|
||||
a super-simple configuration management language that takes minutes to learn.
|
||||
|
||||
Generally speaking, Ansible is answer to the question "why is the world's systems
|
||||
management software so complicated?" The code does not try to show off. It is an
|
||||
experiment in radical simplicity and encourages anyone to be able to easily contribute to it.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td><B><U>Ansible</U></B></font></td>
|
||||
<td>Puppet</td>
|
||||
<td>Chef</td>
|
||||
<td>Func</td>
|
||||
<td>Capistrano</td>
|
||||
<td>mCollective</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Purpose</td>
|
||||
<td><B>Config, Deployment, Ad-Hoc</B></td>
|
||||
<td>Config, Deployment</td>
|
||||
<td>Config, Deployment</td>
|
||||
<td>Ad-Hoc</td>
|
||||
<td>Deployment</td>
|
||||
<td>Ad-Hoc</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Inspirations</td>
|
||||
<td>Cobbler, Puppet, Func, Taboot</B></td>
|
||||
<td>cfengine</td>
|
||||
<td>puppet</td>
|
||||
<td>sysadmin SSH scripts</td>
|
||||
<td>sysadmin SSH scripts</td>
|
||||
<td>Func, puppet</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td>Config Language</td>
|
||||
<td><B>Simple YAML format</B></td>
|
||||
<td>Custom DSL</td>
|
||||
<td>Ruby code</td>
|
||||
<td>None</td>
|
||||
<td>None</td>
|
||||
<td>None</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Config Language Style</td>
|
||||
<td><B>Very simple</B></td>
|
||||
<td>Very rich, complex</td>
|
||||
<td>Very rich, complex</td>
|
||||
<td>None</td>
|
||||
<td>None</td>
|
||||
<td>None</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Config Ordering</td>
|
||||
<td><B>Simply ordered, with notifiers</B></td>
|
||||
<td>Strict dependency DAG</td>
|
||||
<td>Simply ordered</td>
|
||||
<td>None</td>
|
||||
<td>Simply ordered</td>
|
||||
<td>None</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Communication</td>
|
||||
<td>SSH push</td>
|
||||
<td>SSL pull or push trigger</td>
|
||||
<td>SSL pull or push trigger(?)</td>
|
||||
<td>SSL push</td>
|
||||
<td>SSH</td>
|
||||
<td>AMQP bus</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Daemons Required?</td>
|
||||
<td><B>no</B></td>
|
||||
<td>yes</td>
|
||||
<td>yes</td>
|
||||
<td>yes</td>
|
||||
<td><B>no</B></td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Database Needed?</td>
|
||||
<td><B>no</B></td>
|
||||
<td>some features</td>
|
||||
<td>yes</td>
|
||||
<td><B>no</B></td>
|
||||
<td><B>no</B></td>
|
||||
<td>some features</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Message Bus Required?</td>
|
||||
<td><B>no</B></td>
|
||||
<td><B>no</B></td>
|
||||
<td>yes</td>
|
||||
<td><B>no</B></td>
|
||||
<td><B>no</B></td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Inventory Features</td>
|
||||
<td>planned</td>
|
||||
<td><B>yes</B></td>
|
||||
<td><B>yes?</B></td>
|
||||
<td>some</td>
|
||||
<td>no</td>
|
||||
<td>no</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Implemented In</td>
|
||||
<td>Python</td>
|
||||
<td>Ruby</td>
|
||||
<td>Ruby, Erlang</td>
|
||||
<td>Python</td>
|
||||
<td>Ruby</td>
|
||||
<td>Ruby</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Extensible In</td>
|
||||
<td><B>Anything</B></td>
|
||||
<td>Ruby</td>
|
||||
<td>Ruby</td>
|
||||
<td>Python</td>
|
||||
<td>Ruby</td>
|
||||
<td>Ruby</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Codebase Size</td>
|
||||
<td><B>Small</B></td>
|
||||
<td>Large</td>
|
||||
<td>Large</td>
|
||||
<td>Medium</td>
|
||||
<td>Medium</td>
|
||||
<td>Medium</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Module Support</td>
|
||||
<td>Emerging</td>
|
||||
<td><B>Wide/Established</B></td>
|
||||
<td><B>Wide/Established</B></td>
|
||||
<td>Medium/Established</td>
|
||||
<td>Poor</td>
|
||||
<td>Medium/Established</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Users Targeted</td>
|
||||
<td><B>Sysadmins, developers, QA, web admins</B></td>
|
||||
<td>Sysadmins</td>
|
||||
<td>Sysadmins, web admins</td>
|
||||
<td>Sysadmins, developers</td>
|
||||
<td>Web admins</td>
|
||||
<td>Sysadmins</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Learning & Setup Curve</td>
|
||||
<td><B>Minimal<B></td>
|
||||
<td>High</td>
|
||||
<td>High</td>
|
||||
<td>Medium</td>
|
||||
<td>Medium</td>
|
||||
<td>Medium</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Can Easily Build Applications On It</td>
|
||||
<td><B>Yes</B></td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td><B>Yes</B></td>
|
||||
<td>No</td>
|
||||
<td>Yes?</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Parallelism & Scaling Tech</td>
|
||||
<td>Fork/Merge</td>
|
||||
<td>Add Servers / Staged Commands / No Server</td>
|
||||
<td>Adding More Erlang</td>
|
||||
<td>Fork/Merge</td>
|
||||
<td>No</td>
|
||||
<td>Message Bus</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Delegated Hierachies</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td><B>Yes</B></td>
|
||||
<td>No</td>
|
||||
<td><B>Yes</B></td>
|
||||
</tr>
|
||||
</td>
|
||||
|
||||
|
||||
@ -0,0 +1,89 @@
|
||||
ansible-playbook(1)
|
||||
===================
|
||||
:doctype:manpage
|
||||
:man source: Ansible
|
||||
:man version: 0.0.1
|
||||
:man manual: System administration commands
|
||||
|
||||
NAME
|
||||
----
|
||||
ansible-playbook - run an ansible playbook
|
||||
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
ansible-playbook <filename.yml> ... [options]
|
||||
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
|
||||
*Ansible playbooks* 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.
|
||||
|
||||
|
||||
ARGUMENTS
|
||||
---------
|
||||
|
||||
*filename.yml*::
|
||||
|
||||
The names of one or more YAML format files to run as ansible playbooks.
|
||||
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
|
||||
|
||||
*-i*, *--inventory*::
|
||||
|
||||
Path to the inventory hosts file, which defaults to /etc/ansible/hosts.
|
||||
|
||||
|
||||
*-M*, *--module-path*::
|
||||
|
||||
Where to load modules from. The default is /usr/share/ansible
|
||||
|
||||
|
||||
*-f*, *--forks*::
|
||||
|
||||
Desired level of parallelism. Default 5.
|
||||
|
||||
|
||||
*-k*, *--ask-pass*::
|
||||
|
||||
Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.
|
||||
|
||||
|
||||
ENVIRONMENT
|
||||
-----------
|
||||
|
||||
The following environment variables may specified.
|
||||
|
||||
ANSIBLE_HOSTS -- Override the default ansible hosts file
|
||||
|
||||
ANSIBLE_LIBRARY -- Override the default ansible module library path
|
||||
|
||||
|
||||
AUTHOR
|
||||
------
|
||||
|
||||
Ansible was originally written by Michael DeHaan. See the AUTHORS file
|
||||
for a complete list of contributors.
|
||||
|
||||
|
||||
COPYRIGHT
|
||||
---------
|
||||
|
||||
Copyright © 2012, Michael DeHaan
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
|
||||
Extensive documentation as well as IRC and mailing list info
|
||||
is available on the ansible home page: <https://ansible.github.com/>
|
||||
|
||||
|
||||
|
||||
Loading…
Reference in New Issue