No description
Find a file
2012-08-18 19:43:45 -04:00
bin make callbacks modular 2012-08-18 19:43:08 -04:00
docs/man Fully document the -v option. 2012-08-15 10:13:38 -04:00
examples Add examples of the 'serial' and 'delegate_to' keywords to examples/playbooks. 2012-08-18 10:11:17 -04:00
hacking Allow unicode transfer by not base64 encoding. Also: faster 2012-08-02 21:20:43 -04:00
lib/ansible make callbacks modular 2012-08-18 19:43:08 -04:00
library Fix invalid usage or fail_json in apt module 2012-08-18 19:43:45 -04:00
packaging Add some docs/examples 2012-08-14 13:05:44 -04:00
test Always load group_vars and host_vars. 2012-08-13 21:08:05 -07:00
.gitignore clean exec bits from lib/ansible/*.py, ignore Eclipse/PyDev files 2012-04-14 21:35:51 +02:00
CHANGELOG.md Adds the 'serial' keyword to a playbook which controls how many hosts can be running through a playbook at a single time. 2012-08-18 09:52:13 -04:00
COPYING license file should be in source tree 2012-03-15 20:24:22 -04:00
Makefile If ANSIBLE_KEEP_REMOTE_FILES=1 is set as an environment file, remote files will not be deleted, which is useful only for development debugging purposes. 2012-08-16 21:34:55 -04:00
MANIFEST.in Add some docs/examples 2012-08-14 13:05:44 -04:00
README.md update changelog 2012-08-06 21:15:39 -04:00
RELEASES.txt Add list of releases 2012-08-06 21:32:49 -04:00
setup.py If ANSIBLE_KEEP_REMOTE_FILES=1 is set as an environment file, remote files will not be deleted, which is useful only for development debugging purposes. 2012-08-16 21:34:55 -04:00
VERSION Release bump 2012-08-06 19:55:27 -04:00

Ansible

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

Read the documentation at http://ansible.github.com

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 release 0.7, "Panama".
  • Various release-X.Y branches exist for previous releases
  • All feature work happens on the development branch.
  • Major bug fixes will be made to the last release branch only
  • See CHANGELOG.md for release notes to track each release.

Patch Instructions

Contributions to the core and modules are greatly welcome.

  • Required Process:
    • Submit github pull requests to the "ansible/devel" branch for features
    • Fixes for bugs may also be submitted to "ansible/release-X.Y" for the last release
    • Make sure "make tests" passes before submitting any requests.
  • Bonus points:
    • Joining the mailing list
    • Fixing bugs instead of sending bug reports.
    • Using squash merges
    • Updating the "rst/*" files in the docs project and "docs/" manpage content
    • Adding more unit tests
  • Avoid:
    • Sending patches to the mailing list directly.
    • Sending feature pull requests to the 'release' branch instead of the devel branch
    • Sending pull requests to mpdehaan's personal ansible fork.

Author

Michael DeHaan -- michael.dehaan@gmail.com

http://michaeldehaan.net