1af7c6c003
* Feature freeze date has been merged with Ansible-2.10.0beta1 (#71494) (cherry picked from commitc586d436fa) * Add --allow-disabled to sanity docs (#71524) (cherry picked from commitbc6461432e) * Update intro_patterns.rst (#71542) Call out the trailing comma when specifying a single host. Small snag that took me a while to notice. (cherry picked from commitec3920cef1) * ansible-vault: Fix typo in help message (#71485) (cherry picked from commit215eb730e1) * update install for 2.10 (#71543) * update install for 2.10 (cherry picked from commitf75223d2c6) * User guide overhaul, Table of Contents (#71553) (cherry picked from commitb694dbadfe) * update backport instructions for 2.11 (#71567) * update backport instructions in docs/docsite/rst/community/development_process.rst Co-authored-by: Matt Martz <matt@sivel.net> (cherry picked from commit7f9258b024) * More docs updates to reflect collections ecosystem (#71597) (cherry picked from commit96aee766f4) * DOCS: Mentions ansible-base, adds collections pointers to Community and Dev Guides (#71480) (cherry picked from commit29b20bd1b1) Co-authored-by: Toshio Kuratomi <a.badger@gmail.com> Co-authored-by: Amin Vakil <info@aminvakil.com> Co-authored-by: Matt Deacalion <matt@dirtymonkey.co.uk> Co-authored-by: Fabien Malfoy <fabien.malfoy@laposte.net> Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
70 lines
3.7 KiB
ReStructuredText
70 lines
3.7 KiB
ReStructuredText
.. _modules_support:
|
|
|
|
****************************
|
|
Module Maintenance & Support
|
|
****************************
|
|
|
|
If you are using a module and you discover a bug, you may want to know where to report that bug, who is responsible for fixing it, and how you can track changes to the module. If you are a Red Hat subscriber, you may want to know whether you can get support for the issue you are facing.
|
|
|
|
Starting in Ansible 2.10, most modules live in collections. The distribution method for each collection reflects the maintenance and support for the modules in that collection.
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
Maintenance
|
|
===========
|
|
|
|
.. table::
|
|
:class: documentation-table
|
|
|
|
============================= ========================================== ==========================
|
|
Collection Code location Maintained by
|
|
============================= ========================================== ==========================
|
|
ansible.builtin `ansible/ansible repo`_ on GitHub core team
|
|
|
|
distributed on Galaxy various; follow ``repo`` link community or partners
|
|
|
|
distributed on Automation Hub various; follow ``repo`` link content team or partners
|
|
============================= ========================================== ==========================
|
|
|
|
.. _ansible/ansible repo: https://github.com/ansible/ansible/tree/devel/lib/ansible/modules
|
|
|
|
Issue Reporting
|
|
===============
|
|
|
|
If you find a bug that affects a plugin in the main Ansible repo, also known as ``ansible-base``:
|
|
|
|
#. Confirm that you are running the latest stable version of Ansible or the devel branch.
|
|
#. Look at the `issue tracker in the Ansible repo <https://github.com/ansible/ansible/issues>`_ to see if an issue has already been filed.
|
|
#. Create an issue if one does not already exist. Include as much detail as you can about the behavior you discovered.
|
|
|
|
If you find a bug that affects a plugin in a Galaxy collection:
|
|
|
|
#. Find the collection on Galaxy.
|
|
#. Find the issue tracker for the collection.
|
|
#. Look there to see if an issue has already been filed.
|
|
#. Create an issue if one does not already exist. Include as much detail as you can about the behavior you discovered.
|
|
|
|
Some partner collections may be hosted in private repositories.
|
|
|
|
If you are not sure whether the behavior you see is a bug, if you have questions, if you want to discuss development-oriented topics, or if you just want to get in touch, use one of our Google groups or IRC channels to :ref:`communicate with Ansiblers <communication>`.
|
|
|
|
If you find a bug that affects a module in an Automation Hub collection:
|
|
|
|
#. If the collection offers an Issue Tracker link on Automation Hub, click there and open an issue on the collection repository. If it does not, follow the standard process for reporting issues on the `Red Hat Customer Portal <https://access.redhat.com/>`_. You must have a subscription to the Red Hat Ansible Automation Platform to create an issue on the portal.
|
|
|
|
Support
|
|
=======
|
|
|
|
All plugins that remain in ``ansible-base`` and all collections hosted in Automation Hub are supported by Red Hat. No other plugins or collections are supported by Red Hat. If you have a subscription to the Red Hat Ansible Automation Platform, you can find more information and resources on the `Red Hat Customer Portal. <https://access.redhat.com/>`_
|
|
|
|
.. seealso::
|
|
|
|
:ref:`intro_adhoc`
|
|
Examples of using modules in /usr/bin/ansible
|
|
:ref:`working_with_playbooks`
|
|
Examples of using modules with /usr/bin/ansible-playbook
|
|
`Mailing List <https://groups.google.com/group/ansible-project>`_
|
|
Questions? Help? Ideas? Stop by the list on Google Groups
|
|
`irc.freenode.net <http://irc.freenode.net>`_
|
|
#ansible IRC chat channel
|