ansible/docs/docsite/rst/modules_support.rst
2017-09-06 19:39:07 -07:00

62 lines
3 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Module Maintenance & Support
----------------------------
.. toctree:: :maxdepth: 1
To help identify maintainers and understand how the included modules are officially supported, each module now has associated metadata that provides additional clarity for maintenance and support.
Core
````
:doc:`Core modules are maintained by the Ansible Engineering Team<core_maintained>`.
These modules are integral to the basic foundations of the Ansible distribution.
Network
```````
:doc:`Network modules are maintained by the Ansible Network Team<network_maintained>`. Please note there are `additional networking modules <list_of_network_modules>` that are categorized as Certified or Community not maintained by Ansible.
Certified
`````````
Certified modules are part of a future planned program currently in development.
Community
`````````
:doc:`Community modules are submitted and maintained by the Ansible community<community_maintained>`. These modules are not maintained by Ansible, and are included as a convenience.
Issue Reporting
```````````````
If you believe you have found a bug in a module and are already running the latest stable or development version of Ansible, first look at the `issue tracker in the Ansible repo <https://github.com/ansible/ansible/issues>` to see if an issue has already been filed. If not, please file one.
Should you have a question rather than a bug report, inquiries are welcome on the `ansible-project Google group <https://groups.google.com/forum/#%21forum/ansible-project>` or on Ansibles “#ansible” channel, located on irc.freenode.net.
For development-oriented topics, use the `ansible-devel Google group <https://groups.google.com/forum/#%21forum/ansible-devel>` or Ansibles #ansible and #ansible-devel channels, located on irc.freenode.net. You should also read `Community Information & Contributing <community>`, `Testing Ansible <testing>`, and `Developing Modules <developing_modules>`.
The modules are hosted on GitHub in a subdirectory of the `Ansible <https://github.com/ansible/ansible/tree/devel/lib/ansible/modules>` repo.
NOTE: If you have a Red Hat Ansible Engine product subscription, please follow the standard issue reporting process via the Red Hat Customer Portal.
Support
```````
For more information on how included Ansible modules are supported by Red Hat,
please refer to the following `knowledgebase article <https://access.redhat.com/articles/3166901>` as well as other resources on the `Red Hat Customer Portal <https://access.redhat.com/>`.
.. seealso::
:doc:`intro_adhoc`
Examples of using modules in /usr/bin/ansible
:doc:`playbooks`
Examples of using modules with /usr/bin/ansible-playbook
:doc:`dev_guide/developing_modules`
How to write your own modules
:doc:`dev_guide/developing_api`
Examples of using modules with the Python API
`Mailing List <http://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