You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Chad Ostrowski 0bb145af40 Mention vars_files before the Roles section
The Roles section assumes some familiarity with vars_files, which this note attempts to briefly provide.
12 years ago
bin Make plugin loader path operations more efficient. 12 years ago
docs/man Update release version. 12 years ago
docsite Mention vars_files before the Roles section 12 years ago
examples Rename set_up and tear_down to pre_tasks and post_tasks 12 years ago
hacking Restructure hacking readme. 12 years ago
lib/ansible Allow handlers to run in between pre_tasks, roles, tasks, and post_tasks. 12 years ago
library Since using platform.node, be sure to just return the hostname component. 12 years ago
packaging added missing build deps for debian/ubuntu to readme 12 years ago
plugins Instantiate callback plugins only once so we can set play/task objects on them and they'll stick. 12 years ago
test copy action plug-in check mode respects force=no 12 years ago
.gitignore Smush Jinja2 braces in playbooks so unresolved variables get parsed nicely 12 years ago
CHANGELOG.md Update changelog 12 years ago
CONTRIBUTING.md Add a line about testing. 12 years ago
COPYING license file should be in source tree 13 years ago
MANIFEST.in Add some docs/examples 12 years ago
Makefile Smush Jinja2 braces in playbooks so unresolved variables get parsed nicely 12 years ago
README.md Update README.md 12 years ago
RELEASES.txt Update the release date & code names in the releases file. 12 years ago
VERSION Update release version. 12 years ago
setup.py CLI: ansible-doc shows lists of modules & module docs on command-line 12 years ago

README.md

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@ansibleworks.com

AnsibleWorks