1Metadata-Version: 1.2
2Name: ansible
3Version: 4.7.0
4Summary: Radically simple IT automation
5Home-page: https://ansible.com/
6Author: Ansible, Inc.
7Author-email: info@ansible.com
8License: GPLv3+
9Project-URL: Bug Tracker, https://github.com/ansible/ansible/issues
10Project-URL: CI: Shippable, https://app.shippable.com/github/ansible/ansible
11Project-URL: Code of Conduct, https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
12Project-URL: Documentation, https://docs.ansible.com/ansible/
13Project-URL: Mailing lists, https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information
14Project-URL: Source Code, https://github.com/ansible/ansible
15Description: |PyPI version| |Docs badge| |Chat badge| |Build Status| |Code Of Conduct| |Mailing Lists| |License|
16
17        *******
18        Ansible
19        *******
20
21        Ansible is a radically simple IT automation system. It handles configuration management, application
22        deployment, cloud provisioning, ad-hoc task execution, network automation, and multi-node
23        orchestration. Ansible makes complex changes like zero-downtime rolling updates with load balancers
24        easy. More information on `the Ansible website <https://ansible.com/>`_.
25
26        Design Principles
27        =================
28
29        *  Have a dead simple setup process and a minimal learning curve.
30        *  Manage machines very quickly and in parallel.
31        *  Avoid custom-agents and additional open ports, be agentless by
32           leveraging the existing SSH daemon.
33        *  Describe infrastructure in a language that is both machine and human
34           friendly.
35        *  Focus on security and easy auditability/review/rewriting of content.
36        *  Manage new remote machines instantly, without bootstrapping any
37           software.
38        *  Allow module development in any dynamic language, not just Python.
39        *  Be usable as non-root.
40        *  Be the easiest IT automation system to use, ever.
41
42        Use Ansible
43        ===========
44
45        You can install a released version of Ansible via ``pip``, a package manager, or
46        our `release repository <https://releases.ansible.com/ansible/>`_. See our
47        `installation guide <https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html>`_ for details on installing Ansible
48        on a variety of platforms.
49
50        Red Hat offers supported builds of `Ansible Engine <https://www.ansible.com/ansible-engine>`_.
51
52        Power users and developers can run the ``devel`` branch, which has the latest
53        features and fixes, directly. Although it is reasonably stable, you are more likely to encounter
54        breaking changes when running the ``devel`` branch. We recommend getting involved
55        in the Ansible community if you want to run the ``devel`` branch.
56
57        Get Involved
58        ============
59
60        *  Read `Community Information <https://docs.ansible.com/ansible/latest/community>`_ for all kinds
61           of ways to contribute to and interact with the project, including mailing list information and how
62           to submit bug reports and code to Ansible.
63        *  Join a `Working Group <https://github.com/ansible/community/wiki>`_, an organized community
64           devoted to a specific technology domain or platform.
65        *  Submit a proposed code update through a pull request to the ``devel`` branch.
66        *  Talk to us before making larger changes
67           to avoid duplicate efforts. This not only helps everyone
68           know what is going on, it also helps save time and effort if we decide
69           some changes are needed.
70        *  For a list of email lists, IRC channels and Working Groups, see the
71           `Communication page <https://docs.ansible.com/ansible/latest/community/communication.html>`_
72
73        Coding Guidelines
74        =================
75
76        We document our Coding Guidelines in the `Developer Guide <https://docs.ansible.com/ansible/devel/dev_guide/>`_. We particularly suggest you review:
77
78        * `Contributing your module to Ansible <https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_checklist.html>`_
79        * `Conventions, tips and pitfalls <https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_best_practices.html>`_
80
81        Branch Info
82        ===========
83
84        *  The ``devel`` branch corresponds to the release actively under development.
85        *  The ``stable-2.X`` branches correspond to stable releases.
86        *  Create a branch based on ``devel`` and set up a `dev environment <https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_general.html#common-environment-setup>`_ if you want to open a PR.
87        *  See the `Ansible release and maintenance <https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html>`_ page for information about active branches.
88
89        Roadmap
90        =======
91
92        Based on team and community feedback, an initial roadmap will be published for a major or minor
93        version (ex: 2.7, 2.8).  The `Ansible Roadmap page
94        <https://docs.ansible.com/ansible/devel/roadmap/>`_ details what is planned and how to influence the
95        roadmap.
96
97        Authors
98        =======
99
100        Ansible was created by `Michael DeHaan <https://github.com/mpdehaan>`_
101        and has contributions from over 4700 users (and growing). Thanks everyone!
102
103        `Ansible <https://www.ansible.com>`_ is sponsored by `Red Hat, Inc.
104        <https://www.redhat.com>`_
105
106        License
107        =======
108
109        GNU General Public License v3.0 or later
110
111        See `COPYING <COPYING>`_ to see the full text.
112
113        .. |PyPI version| image:: https://img.shields.io/pypi/v/ansible.svg
114           :target: https://pypi.org/project/ansible
115        .. |Docs badge| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
116           :target: https://docs.ansible.com/ansible/latest/
117        .. |Build Status| image:: https://api.shippable.com/projects/573f79d02a8192902e20e34b/badge?branch=devel
118           :target: https://app.shippable.com/projects/573f79d02a8192902e20e34b
119        .. |Chat badge| image:: https://img.shields.io/badge/chat-IRC-brightgreen.svg
120           :target: https://docs.ansible.com/ansible/latest/community/communication.html
121        .. |Code Of Conduct| image:: https://img.shields.io/badge/code%20of%20conduct-Ansible-silver.svg
122           :target: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
123           :alt: Ansible Code of Conduct
124        .. |Mailing Lists| image:: https://img.shields.io/badge/mailing%20lists-Ansible-orange.svg
125           :target: https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information
126           :alt: Ansible mailing lists
127        .. |License| image:: https://img.shields.io/badge/license-GPL%20v3.0-brightgreen.svg
128           :target: COPYING
129           :alt: Repository License
130
131Platform: UNKNOWN
132Classifier: Development Status :: 5 - Production/Stable
133Classifier: Environment :: Console
134Classifier: Framework :: Ansible
135Classifier: Intended Audience :: Developers
136Classifier: Intended Audience :: Information Technology
137Classifier: Intended Audience :: System Administrators
138Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
139Classifier: Natural Language :: English
140Classifier: Operating System :: POSIX
141Classifier: Programming Language :: Python :: 2
142Classifier: Programming Language :: Python :: 2.7
143Classifier: Programming Language :: Python :: 3
144Classifier: Programming Language :: Python :: 3.5
145Classifier: Programming Language :: Python :: 3.6
146Classifier: Programming Language :: Python :: 3.7
147Classifier: Programming Language :: Python :: 3.8
148Classifier: Topic :: System :: Installation/Setup
149Classifier: Topic :: System :: Systems Administration
150Classifier: Topic :: Utilities
151Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
152