2012-02-23 20:17:24 +01:00
|
|
|
Ansible
|
|
|
|
|
=======
|
|
|
|
|
|
2012-03-08 19:59:12 +01:00
|
|
|
Ansible is a radically simple configuration-management, deployment, task-execution, and
|
|
|
|
|
multinode orchestration framework.
|
2012-02-23 20:17:24 +01:00
|
|
|
|
2012-08-01 14:16:21 +02:00
|
|
|
Read the documentation at http://ansible.github.com
|
2012-02-24 03:47:31 +01:00
|
|
|
|
|
|
|
|
Design Principles
|
|
|
|
|
=================
|
2012-02-23 20:17:24 +01:00
|
|
|
|
2012-02-28 03:26:23 +01:00
|
|
|
* 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
|
2012-03-08 19:59:12 +01:00
|
|
|
* The easiest config management system to use, ever.
|
2012-02-23 20:17:24 +01:00
|
|
|
|
2012-03-08 19:59:12 +01:00
|
|
|
Get Involved
|
2012-02-23 20:17:24 +01:00
|
|
|
============
|
|
|
|
|
|
2012-03-02 03:18:32 +01:00
|
|
|
* [ansible-project mailing list](http://groups.google.com/group/ansible-project)
|
|
|
|
|
* irc.freenode.net: #ansible
|
2012-02-29 19:58:46 +01:00
|
|
|
|
2012-04-26 03:23:50 +02:00
|
|
|
Branch Info
|
|
|
|
|
===========
|
|
|
|
|
|
2012-07-05 00:06:38 +02:00
|
|
|
* Releases are named after Van Halen songs.
|
|
|
|
|
* The master branch corresponds to release 0.5 "Amsterdam".
|
|
|
|
|
* The devel branch corresponds to release 0.6 "Cabo".
|
|
|
|
|
* All feature work happens on the development branch.
|
|
|
|
|
* Major bug fixes will be made to the master branch, but not minor ones.
|
2012-04-26 03:23:50 +02:00
|
|
|
* See CHANGELOG.md for release notes to track each release.
|
|
|
|
|
|
2012-03-31 17:38:06 +02:00
|
|
|
Patch Instructions
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
Contributions to the core and modules are greatly welcome.
|
|
|
|
|
|
|
|
|
|
* Required Process:
|
2012-04-24 03:18:57 +02:00
|
|
|
* Submit github pull requests to the "ansible/devel" branch for features
|
|
|
|
|
* Fixes for bugs may be submitted to "ansible/master"
|
2012-03-31 17:38:06 +02:00
|
|
|
* Make sure "make tests" passes before submitting any requests.
|
|
|
|
|
* Bonus points:
|
|
|
|
|
* Joining the mailing list
|
2012-07-04 20:03:59 +02:00
|
|
|
* Fixing bugs instead of sending bug reports.
|
2012-03-31 17:38:06 +02:00
|
|
|
* 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.
|
2012-04-24 03:18:57 +02:00
|
|
|
* Sending feature pull requests to the 'master' branch instead of the devel branch
|
2012-03-31 17:38:06 +02:00
|
|
|
* Sending pull requests to mpdehaan's personal ansible fork.
|
|
|
|
|
|
2012-07-04 20:03:59 +02:00
|
|
|
|
2012-02-23 20:17:24 +01:00
|
|
|
Author
|
|
|
|
|
======
|
|
|
|
|
|
2012-02-24 03:47:31 +01:00
|
|
|
Michael DeHaan -- michael.dehaan@gmail.com
|
2012-02-23 20:28:39 +01:00
|
|
|
|
2012-02-24 03:47:31 +01:00
|
|
|
[http://michaeldehaan.net](http://michaeldehaan.net/)
|
2012-02-23 20:28:39 +01:00
|
|
|
|
|
|
|
|
|
