No description
Find a file
Michael DeHaan b11cf15b3e Merge pull request #2302 from leucos/patch-1
Update playbooks2.rst
2013-03-05 17:14:47 -08:00
bin Add support for additional EXAMPLES string in Ansible modules 2013-02-18 20:02:46 +01:00
docs/man align manpages with actual code for --syntax-check 2013-03-06 00:42:53 +01:00
docsite Merge pull request #2302 from leucos/patch-1 2013-03-05 17:14:47 -08:00
examples Fix example crypt to include trailing $ 2013-03-05 21:39:28 +01:00
hacking Adding a script to auto-generate an authors file, runnable from 'make authors', which is called from 'make docs/webdocs'. 2013-02-26 22:05:17 -05:00
lib/ansible Make apt upgrade=dist work and make its argument handling more idiomatic 2013-03-05 23:46:34 +01:00
library Make apt upgrade=dist work and make its argument handling more idiomatic 2013-03-05 23:46:34 +01:00
packaging Adopt best practices with distributing portfiles 2013-02-26 21:13:04 +00:00
plugins more places to use yaml.safe_load 2013-02-23 13:34:14 -05:00
test Disable filter test for now since it should really be testing at a lower level. 2013-03-01 17:42:14 -05:00
.gitignore Fix documentation consistency in .gitignore 2012-10-12 17:37:30 -04:00
AUTHORS.TXT Increase error handling in the unlikely case of failing to establish a connection. 2013-03-01 21:39:50 -05:00
CHANGELOG.md Update changelog to include recent modifications. 2013-03-02 00:01:43 -05:00
CONTRIBUTING.md Add a line about testing. 2013-02-23 12:41:00 -05:00
COPYING license file should be in source tree 2012-03-15 20:24:22 -04:00
Makefile Update the Makefile and build-site.py to notify of missing dependencies for doc compiling 2013-03-05 13:59:39 -05:00
MANIFEST.in Add some docs/examples 2012-08-14 13:05:44 -04:00
README.md Update README.md 2013-02-03 22:20:04 -05:00
RELEASES.txt Fix up some version related things on the devel branch. 2013-02-01 21:38:21 -05:00
setup.py CLI: ansible-doc shows lists of modules & module docs on command-line 2012-11-30 21:57:25 -05:00
VERSION Fix up some version related things on the devel branch. 2013-02-01 21:38:21 -05:00

Ansible

Ansible is a radically simple configuration-management, deployment, task-execution, and multinode orchestration framework.

Read the documentation and more at http://ansible.cc

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 instructions on http://ansible.cc/docs/gettingstarted.html for a variety of platforms. If you want a tarball of the last release, go to http://ansible.cc/releases/ and you can also install with pip (though that will bring in some optional binary dependencies you normally do not need).

Design Principles

  • 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
  • The easiest config management system to use, ever.

Get Involved

Branch Info

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

Author

Michael DeHaan -- michael.dehaan@gmail.com

http://michaeldehaan.net