|
| 1 | +Metadata-Version: 1.2 |
| 2 | +Name: ansible-base |
| 3 | +Version: 2.10.2.post0 |
| 4 | +Summary: Radically simple IT automation |
| 5 | +Home-page: https://ansible.com/ |
| 6 | +Author: Ansible, Inc. |
| 7 | +Author-email: info@ansible.com |
| 8 | +License: GPLv3+ |
| 9 | +Project-URL: Bug Tracker, https://github.com/ansible/ansible/issues |
| 10 | +Project-URL: CI: Shippable, https://app.shippable.com/github/ansible/ansible |
| 11 | +Project-URL: Code of Conduct, https://docs.ansible.com/ansible/latest/community/code_of_conduct.html |
| 12 | +Project-URL: Documentation, https://docs.ansible.com/ansible/ |
| 13 | +Project-URL: Mailing lists, https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information |
| 14 | +Project-URL: Source Code, https://github.com/ansible/ansible |
| 15 | +Description: |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 |
| 22 | + configuration management, application deployment, cloud provisioning, |
| 23 | + ad-hoc task execution, network automation, and multi-node orchestration. Ansible makes complex |
| 24 | + changes like zero-downtime rolling updates with load balancers 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 |
| 61 | + Information <https://docs.ansible.com/ansible/latest/community>`_ for all |
| 62 | + kinds of ways to contribute to and interact with the project, |
| 63 | + including mailing list information and how to submit bug reports and |
| 64 | + code to Ansible. |
| 65 | + * Join a `Working Group |
| 66 | + <https://github.com/ansible/community/wiki>`_, an organized community devoted to a specific technology domain or platform. |
| 67 | + * Submit a proposed code update through a pull request to the ``devel`` branch. |
| 68 | + * Talk to us before making larger changes |
| 69 | + to avoid duplicate efforts. This not only helps everyone |
| 70 | + know what is going on, it also helps save time and effort if we decide |
| 71 | + some changes are needed. |
| 72 | + * For a list of email lists, IRC channels and Working Groups, see the |
| 73 | + `Communication page <https://docs.ansible.com/ansible/latest/community/communication.html>`_ |
| 74 | + |
| 75 | + Coding Guidelines |
| 76 | + ================= |
| 77 | + |
| 78 | + We document our Coding Guidelines in the `Developer Guide <https://docs.ansible.com/ansible/devel/dev_guide/>`_. We particularly suggest you review: |
| 79 | + |
| 80 | + * `Contributing your module to Ansible <https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_checklist.html>`_ |
| 81 | + * `Conventions, tips and pitfalls <https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_best_practices.html>`_ |
| 82 | + |
| 83 | + Branch Info |
| 84 | + =========== |
| 85 | + |
| 86 | + * The ``devel`` branch corresponds to the release actively under development. |
| 87 | + * The ``stable-2.X`` branches correspond to stable releases. |
| 88 | + * 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. |
| 89 | + * See the `Ansible release and maintenance <https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html>`_ page for information about active branches. |
| 90 | + |
| 91 | + Roadmap |
| 92 | + ======= |
| 93 | + |
| 94 | + Based on team and community feedback, an initial roadmap will be published for a major or minor version (ex: 2.7, 2.8). |
| 95 | + The `Ansible Roadmap page <https://docs.ansible.com/ansible/devel/roadmap/>`_ details what is planned and how to influence the 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 | + |
| 131 | +Platform: UNKNOWN |
| 132 | +Classifier: Development Status :: 5 - Production/Stable |
| 133 | +Classifier: Environment :: Console |
| 134 | +Classifier: Intended Audience :: Developers |
| 135 | +Classifier: Intended Audience :: Information Technology |
| 136 | +Classifier: Intended Audience :: System Administrators |
| 137 | +Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+) |
| 138 | +Classifier: Natural Language :: English |
| 139 | +Classifier: Operating System :: POSIX |
| 140 | +Classifier: Programming Language :: Python :: 2 |
| 141 | +Classifier: Programming Language :: Python :: 2.7 |
| 142 | +Classifier: Programming Language :: Python :: 3 |
| 143 | +Classifier: Programming Language :: Python :: 3.5 |
| 144 | +Classifier: Programming Language :: Python :: 3.6 |
| 145 | +Classifier: Programming Language :: Python :: 3.7 |
| 146 | +Classifier: Programming Language :: Python :: 3.8 |
| 147 | +Classifier: Topic :: System :: Installation/Setup |
| 148 | +Classifier: Topic :: System :: Systems Administration |
| 149 | +Classifier: Topic :: Utilities |
| 150 | +Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.* |
0 commit comments