summaryrefslogtreecommitdiff
path: root/README.md
blob: 3292f455358ae19ff1b243e81990921a6ed77ddf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
Ansible
=======

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

Read all about at it 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
============

   * [ansible-project mailing list](http://groups.google.com/group/ansible-project)
   * irc.freenode.net: #ansible

Branch Info
===========

   * The master branch corresponds to release 0.4 "Unchained".
   * Bug fixes WILL be periodically made to the master branch.
   * The devel branch corresponds to release 0.5 "Amsterdam".
   * Note: sudo support works much better in 0.5/devel, consider trying it.
   * 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 be submitted to "ansible/master"
       * Make sure "make tests" passes before submitting any requests.
   * Bonus points:
       * Joining the mailing list
       * 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 'master' 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](http://michaeldehaan.net/)