README.md 1.64 KB
Newer Older
Michael DeHaan committed
1 2 3
Ansible
=======

Michael DeHaan committed
4 5
Ansible is a radically simple configuration-management, deployment, task-execution, and
multinode orchestration framework.
Michael DeHaan committed
6

7
Read the documentation and more at http://ansibleworks.com/
8

Michael DeHaan committed
9
Many users run straight from the development branch (it's generally fine to do so), but you might also wish to consume a release.  You can find 
10 11
instructions on http://ansibleworks.com/docs/gettingstarted.html for a variety of platforms.  If you want a tarball of the last release, go to 
http://ansibleworks.com/releases/ and you can also install with pip (though that will bring in some optional binary dependencies you normally do not need).
Michael DeHaan committed
12

13 14
Design Principles
=================
Michael DeHaan committed
15

Michael DeHaan committed
16 17 18 19 20 21 22
   * Dead simple setup
   * Super fast & parallel by default
   * No server or client daemons; use existing SSHd
   * No additional software required on client boxes
   * Modules can be written in ANY language
   * Awesome API for creating very powerful distributed scripts
   * Be usable as non-root
Michael DeHaan committed
23
   * The easiest config management system to use, ever.
Michael DeHaan committed
24

Michael DeHaan committed
25
Get Involved
Michael DeHaan committed
26 27
============

Michael DeHaan committed
28
   * [ansible-project mailing list](http://groups.google.com/group/ansible-project), rss: [here](https://groups.google.com/group/ansible-project/feed/rss_v2_0_msgs.xml?num=50&pli=1)
29
   * irc.freenode.net: #ansible
Michael DeHaan committed
30

Michael DeHaan committed
31 32 33
Branch Info
===========

34
   * Releases are named after Van Halen songs.
35
   * The devel branch corresponds to the release actively under development.
Michael DeHaan committed
36
   * Various release-X.Y branches exist for previous releases
37
   * We'd love to have your contributions, read "CONTRIBUTING.md" for process notes.
38

Michael DeHaan committed
39 40 41
Author
======

Michael DeHaan committed
42
Michael DeHaan -- michael@ansibleworks.com
Michael DeHaan committed
43

Michael DeHaan committed
44
[AnsibleWorks](http://ansibleworks.com)