Ansible is a radically simple IT automation platform that makes your applications and systems easier to deploy and maintain. Automate everything from code deployment to network configuration to cloud management, in a language that approaches plain English, using SSH, with no agents to install on remote systems. https://docs.ansible.com.
|PyPI version| |Docs badge| |Chat badge| |Build Status| |Code Of Conduct| |Mailing Lists| |License| |CII Best Practices|
Ansible is a radically simple IT automation system. It handles configuration management, application deployment, cloud provisioning, ad-hoc task execution, network automation, and multi-node orchestration. Ansible makes complex changes like zero-downtime rolling updates with load balancers easy. More information on
the Ansible website_.
You can install a released version of Ansible with
pipor a package manager. See our
installation guide_ for details on installing Ansible on a variety of platforms.
Red Hat offers supported builds of
Power users and developers can run the
develbranch, which has the latest features and fixes, directly. Although it is reasonably stable, you are more likely to encounter breaking changes when running the
develbranch. We recommend getting involved in the Ansible community if you want to run the
Community Information_ for all kinds of ways to contribute to and interact with the project, including mailing list information and how to submit bug reports and code to Ansible.
Working Group_, an organized community devoted to a specific technology domain or platform.
We document our Coding Guidelines in the
Developer Guide_. We particularly suggest you review:
Contributing your module to Ansible_
Conventions, tips, and pitfalls_
develbranch corresponds to the release actively under development.
stable-2.Xbranches correspond to stable releases.
develand set up a
dev environment_ if you want to open a PR.
Ansible 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). The
Ansible Roadmap page_ details what is planned and how to influence the roadmap.
Ansible was created by
Michael DeHaan_ and has contributions from over 5000 users (and growing). Thanks everyone!
Ansible_ is sponsored by
Red Hat, Inc._
GNU General Public License v3.0 or later
COPYING_ to see the full text.
.. |PyPI version| image:: https://img.shields.io/pypi/v/ansible-core.svg :target: https://pypi.org/project/ansible-core .. |Docs badge| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg :target: https://docs.ansible.com/ansible/latest/ .. |Build Status| image:: https://dev.azure.com/ansible/ansible/apis/build/status/CI?branchName=devel :target: https://dev.azure.com/ansible/ansible/build/latest?definitionId=20&branchName=devel .. |Chat badge| image:: https://img.shields.io/badge/chat-IRC-brightgreen.svg :target: https://docs.ansible.com/ansible/latest/community/communication.html .. |Code Of Conduct| image:: https://img.shields.io/badge/code%20of%20conduct-Ansible-silver.svg :target: https://docs.ansible.com/ansible/latest/community/codeofconduct.html :alt: Ansible Code of Conduct .. |Mailing Lists| image:: https://img.shields.io/badge/mailing%20lists-Ansible-orange.svg :target: https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information :alt: Ansible mailing lists .. |License| image:: https://img.shields.io/badge/license-GPL%20v3.0-brightgreen.svg :target: COPYING :alt: Repository License .. |CII Best Practices| image:: https://bestpractices.coreinfrastructure.org/projects/2372/badge :target: https://bestpractices.coreinfrastructure.org/projects/2372 :alt: Ansible CII Best Practices certification