Repository files navigation

Ansible is a radically simple IT automation system. It handlesconfiguration management, application deployment, cloud provisioning,ad-hoc task execution, network automation, and multi-node orchestration. Ansible makes complexchanges like zero-downtime rolling updates with load balancers easy. More information onthe Ansible website.

• Have a dead simple setup process and a minimal learning curve.
• Manage machines very quickly and in parallel.
• Avoid custom-agents and additional open ports, be agentless byleveraging the existing SSH daemon.
• Describe infrastructure in a language that is both machine and humanfriendly.
• Focus on security and easy auditability/review/rewriting of content.
• Manage new remote machines instantly, without bootstrapping anysoftware.
• Allow module development in any dynamic language, not just Python.
• Be usable as non-root.
• Be the easiest IT automation system to use, ever.

You can install a released version of Ansible viapip, a package manager, orourrelease repository. See ourinstallation guide for details on installing Ansibleon a variety of platforms.

Red Hat offers supported builds ofAnsible Engine.

Power users and developers can run thedevel branch, which has the latestfeatures and fixes, directly. Although it is reasonably stable, you are more likely to encounterbreaking changes when running thedevel branch. We recommend getting involvedin the Ansible community if you want to run thedevel branch.

• ReadCommunityInformation for allkinds of ways to contribute to and interact with the project,including mailing list information and how to submit bug reports andcode to Ansible.
• Join aWorking Group, an organized community devoted to a specific technology domain or platform.
• Submit a proposed code update through a pull request to thedevel branch.
• Talk to us before making larger changesto avoid duplicate efforts. This not only helps everyoneknow what is going on, it also helps save time and effort if we decidesome changes are needed.
• For a list of email lists, IRC channels and Working Groups, see theCommunication page

• Thedevel branch corresponds to the release actively under development.
• Thestable-2.X branches correspond to stable releases.
• Create a branch based ondevel and set up adev environment if you want to open a PR.
• See theAnsible release and maintenance page for information about active branches.

Based on team and community feedback, an initial roadmap will be published for a major or minor version (ex: 2.7, 2.8).TheAnsible Roadmap page details what is planned and how to influence the roadmap.

Ansible was created byMichael DeHaanand has contributions from over 4700 users (and growing). Thanks everyone!

Ansible is sponsored byRed Hat, Inc.

GNU General Public License v3.0 or later

SeeCOPYING to see the full text.